home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 086 / ros37doc.arc / ROSSYS.DOC < prev    next >
Encoding:
Text File  |  1987-09-01  |  132.0 KB  |  3,247 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                               RRRRRR         OOOOO         SSSSS
  15.                              RR   RR       OOO OOO       SS   SS
  16.                             RR   RR       OO   OO       SS
  17.                            RR   RR       OO   OO       SS
  18.                           RRRRRR        OO   OO        SSSSS
  19.                          RRRR          OO   OO            SS
  20.                         RR RR         OO   OO            SS
  21.                        RR  RR        OOO OOO       SS   SS
  22.                       RR   RR        OOOOO         SSSSS
  23.  
  24.                       Remote         Operating     System
  25.  
  26.  
  27.  
  28.                              S Y S O P   M A N U A L
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                          Copyright (c) 1985, 1986, 1987
  36.  
  37.                                All Rights Reserved
  38.  
  39.                                        by
  40.  
  41.                                    Steven Fox
  42.                                2112 White Cloud NE
  43.                         Albuquerque, New Mexico 87112 USA
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                DISTRIBUTION RIGHTS
  51.  
  52.  
  53.         Free, public access bulletin boards are welcome to use ROS  with-
  54.         out charge.  If you and your users find ROS fast and easy to use,
  55.         a  contribution would be appreciated.  Licensed systems  will  be
  56.         registered to receive a diskette and printed documentation of the
  57.         next  version  of ROS when available.  Please state  the  current
  58.         version that you have.  Commercial and government sponsored  sys-
  59.         tems,  including  those which assess a fee for  access,  must  be
  60.         licensed (an invoice is provided at the end of this document).
  61.  
  62.         You  may freely copy and distribute this software and  documenta-
  63.         tion only in its original, unmodified state.  This allows distri-
  64.              ____
  65.         bution  via  bulletin boards, user groups,  and  distributors  of
  66.         public  domain  and shareware software.   Other  than  reasonable
  67.         copying,  shipping, and handling charges, no remuneration may  be
  68.         accepted by any party other than the copyright holder.
  69.  
  70.         Licensed systems may print copies of the User Manual as required.
  71.  
  72.  
  73.         Please refer all inquiries and comments about ROS to
  74.  
  75.              Sysop
  76.              Albuquerque ROS
  77.              (505)299-5974
  78.              300/1200/2400 bps, no parity, 8 bit characters, 1 stop bit
  79.  
  80.           or to
  81.  
  82.              Steven Fox
  83.              2112 White Cloud NE
  84.              Albuquerque, NM 87112
  85.  
  86.  
  87.                                    DISCLAIMER
  88.  
  89.              ROS  and  its associated programs are provided  AS  IS,
  90.              without  warranty  of any kind, expressed  or  implied,
  91.              including, but not limited to, fitness for a particular
  92.              purpose.  In no event will the author be liable for any
  93.              damages arising out of their use.
  94.  
  95.  
  96.  
  97.                        T A B L E   O F   C O N T E N T S
  98.                        T A B L E   O F   C O N T E N T S
  99.                        T A B L E   O F   C O N T E N T S
  100.                        _________________________________
  101.                        _________________________________
  102.                        _________________________________
  103.  
  104.           1. HISTORY AND ACKNOWLEDGMENTS................................1
  105.           1. HISTORY AND ACKNOWLEDGMENTS................................1
  106.           1. HISTORY AND ACKNOWLEDGMENTS................................1
  107.  
  108.           2. MINIMUM SYSTEM.............................................2
  109.           2. MINIMUM SYSTEM.............................................2
  110.           2. MINIMUM SYSTEM.............................................2
  111.  
  112.           3. FILES......................................................3
  113.           3. FILES......................................................3
  114.           3. FILES......................................................3
  115.  
  116.           4. INSTALLING ROS.............................................4
  117.           4. INSTALLING ROS.............................................4
  118.           4. INSTALLING ROS.............................................4
  119.              4.1. Configuring DOS.......................................4
  120.              4.1. Configuring DOS.......................................4
  121.              4.2. Message and file area control file - AREA.ROS.........4
  122.              4.2. Message and file area control file - AREA.ROS.........4
  123.              4.3. ROS configuration file - CONFIG.ROS...................7
  124.              4.3. ROS configuration file - CONFIG.ROS...................7
  125.              4.4. System message file - SYSMTXT.ROS....................13
  126.              4.4. System message file - SYSMTXT.ROS....................13
  127.              4.5. Other files used by ROS..............................16
  128.              4.5. Other files used by ROS..............................16
  129.  
  130.           5. USING THE SYSTEM..........................................18
  131.           5. USING THE SYSTEM..........................................18
  132.           5. USING THE SYSTEM..........................................18
  133.              5.1. Logging in the first time............................18
  134.              5.1. Logging in the first time............................18
  135.              5.2. Status line..........................................18
  136.              5.2. Status line..........................................18
  137.              5.3. When ROS is idling between users.....................19
  138.              5.3. When ROS is idling between users.....................19
  139.              5.4. Local console commands...............................19
  140.              5.4. Local console commands...............................19
  141.                   5.4.1. C/R  Using ROS locally........................19
  142.                   5.4.1. C/R  Using ROS locally........................19
  143.                   5.4.2. F2   Direct connection........................19
  144.                   5.4.2. F2   Direct connection........................19
  145.                   5.4.3. F3   Delayed disable..........................20
  146.                   5.4.3. F3   Delayed disable..........................20
  147.                   5.4.4. F4   Disable remote I/O.......................20
  148.                   5.4.4. F4   Disable remote I/O.......................20
  149.                   5.4.5. F5   Sysop initiated CHAT.....................20
  150.                   5.4.5. F5   Sysop initiated CHAT.....................20
  151.                   5.4.6. F6   Signal key...............................20
  152.                   5.4.6. F6   Signal key...............................20
  153.                   5.4.7. F9   Twit key.................................20
  154.                   5.4.7. F9   Twit key.................................20
  155.                   5.4.8. Shutdown ROS..................................20
  156.                   5.4.8. Shutdown ROS..................................20
  157.  
  158.           6. MAINTENANCE...............................................21
  159.           6. MAINTENANCE...............................................21
  160.           6. MAINTENANCE...............................................21
  161.              6.1. Sysop Sub-system.....................................21
  162.              6.1. Sysop Sub-system.....................................21
  163.              6.2. <A>udit trail toggle.................................21
  164.              6.2. <A>udit trail toggle.................................21
  165.              6.3. <C>atalog operations.................................22
  166.              6.3. <C>atalog operations.................................22
  167.                   6.3.1. <B>uild.......................................22
  168.                   6.3.1. <B>uild.......................................22
  169.                   6.3.2. <D>escribe....................................22
  170.                   6.3.2. <D>escribe....................................22
  171.                   6.3.3. <E>dit........................................23
  172.                   6.3.3. <E>dit........................................23
  173.                          6.3.3.1. Add..................................23
  174.                                   ___
  175.                          6.3.3.2. Backward.............................23
  176.                                   ________
  177.                          6.3.3.3. Change...............................23
  178.                                   ______
  179.                          6.3.3.4. Delete...............................23
  180.                                   ______
  181.                          6.3.3.5. Edit.................................24
  182.                                   ____
  183.                          6.3.3.6. Forward..............................24
  184.                                   _______
  185.                          6.3.3.7. Hide.................................24
  186.                                   ____
  187.                          6.3.3.8. Next.................................25
  188.                                   ____
  189.                          6.3.3.9. Previous.............................25
  190.                                   ________
  191.                          6.3.3.10. Release.............................25
  192.                                    _______
  193.                          6.3.3.11. Select..............................25
  194.                                    ______
  195.                          6.3.3.12. Quit................................25
  196.                                    ____
  197.                   6.3.4. <G>lobal......................................25
  198.                   6.3.4. <G>lobal......................................25
  199.                   6.3.5. <L>eaders.....................................25
  200.                   6.3.5. <L>eaders.....................................25
  201.                   6.3.6. <P>ost........................................26
  202.                   6.3.6. <P>ost........................................26
  203.                   6.3.7. <R>econcile...................................26
  204.                   6.3.7. <R>econcile...................................26
  205.                   6.3.8. <Q>uit........................................26
  206.                   6.3.8. <Q>uit........................................26
  207.              6.4. <E>dit user record...................................27
  208.              6.4. <E>dit user record...................................27
  209.                   6.4.1. <A>dd record..................................27
  210.                   6.4.1. <A>dd record..................................27
  211.  
  212.  
  213.                                        ii
  214.  
  215.  
  216.  
  217.                   6.4.2. <D>elete record...............................27
  218.                   6.4.2. <D>elete record...............................27
  219.                   6.4.3. <E>dit record.................................27
  220.                   6.4.3. <E>dit record.................................27
  221.                   6.4.4. <F>orce password..............................27
  222.                   6.4.4. <F>orce password..............................27
  223.                   6.4.5. <N>ext record.................................28
  224.                   6.4.5. <N>ext record.................................28
  225.                   6.4.6. <P>revious record.............................28
  226.                   6.4.6. <P>revious record.............................28
  227.                   6.4.7. <R>egistered..................................28
  228.                   6.4.7. <R>egistered..................................28
  229.                   6.4.8. <S>elect record...............................28
  230.                   6.4.8. <S>elect record...............................28
  231.                   6.4.9. <V>alidate user...............................28
  232.                   6.4.9. <V>alidate user...............................28
  233.                   6.4.10. <Q>uit edit session..........................28
  234.                   6.4.10. <Q>uit edit session..........................28
  235.              6.5. <I>nitialize system files............................28
  236.              6.5. <I>nitialize system files............................28
  237.              6.6. <J>ump to DOS........................................29
  238.              6.6. <J>ump to DOS........................................29
  239.              6.7. <L>ist system files..................................29
  240.              6.7. <L>ist system files..................................29
  241.                   6.7.1. <A>ll system files............................29
  242.                   6.7.1. <A>ll system files............................29
  243.                   6.7.2. <L>og file....................................29
  244.                   6.7.2. <L>og file....................................29
  245.                   6.7.3. <M>essages....................................29
  246.                   6.7.3. <M>essages....................................29
  247.                   6.7.4. <Q>uit........................................29
  248.                   6.7.4. <Q>uit........................................29
  249.              6.8. <O> Macro operations.................................29
  250.              6.8. <O> Macro operations.................................29
  251.                   6.8.1. Time Initiated Macro..........................30
  252.                   6.8.1. Time Initiated Macro..........................30
  253.                   6.8.2. Macro Examples................................30
  254.                   6.8.2. Macro Examples................................30
  255.              6.9. <P>urge files........................................31
  256.              6.9. <P>urge files........................................31
  257.                   6.9.1. Purge All.....................................31
  258.                   6.9.1. Purge All.....................................31
  259.                   6.9.2. Purge Catalog.................................31
  260.                   6.9.2. Purge Catalog.................................31
  261.                   6.9.3. Purge Log.....................................31
  262.                   6.9.3. Purge Log.....................................31
  263.                   6.9.4. Purge Messages................................31
  264.                   6.9.4. Purge Messages................................31
  265.                   6.9.5. Purge Users...................................31
  266.                   6.9.5. Purge Users...................................31
  267.              6.10. <T>oggle printer....................................32
  268.              6.10. <T>oggle printer....................................32
  269.              6.11. <V>ersions..........................................32
  270.              6.11. <V>ersions..........................................32
  271.              6.12. Other commands available to the sysop...............32
  272.              6.12. Other commands available to the sysop...............32
  273.                    6.12.1. <G>oodbye (logoff)..........................32
  274.                    6.12.1. <G>oodbye (logoff)..........................32
  275.                    6.12.2. <F>ile Transfer System......................32
  276.                    6.12.2. <F>ile Transfer System......................32
  277.                    6.12.3. <M>essage System............................32
  278.                    6.12.3. <M>essage System............................32
  279.                    6.12.4. <U>tility System............................32
  280.                    6.12.4. <U>tility System............................32
  281.                    6.12.5. <X>pert mode toggle.........................32
  282.                    6.12.5. <X>pert mode toggle.........................32
  283.                    6.12.6. Command Enhancements........................33
  284.                    6.12.6. Command Enhancements........................33
  285.                            6.12.6.1. Changing a Message Status or Mess.33
  286.                                      _________________________________
  287.                            6.12.6.2. Setting the System Time and Date..33
  288.                                      ________________________________
  289.                            6.12.6.3. User List Additions...............33
  290.                                      ___________________
  291.  
  292.           7. SECURITY..................................................35
  293.           7. SECURITY..................................................35
  294.           7. SECURITY..................................................35
  295.  
  296.           8. COMMAND LINE OPTIONS......................................36
  297.           8. COMMAND LINE OPTIONS......................................36
  298.           8. COMMAND LINE OPTIONS......................................36
  299.              8.1. Option /r............................................36
  300.              8.1. Option /r............................................36
  301.              8.2. Option /d............................................37
  302.              8.2. Option /d............................................37
  303.              8.3. Option /m............................................37
  304.              8.3. Option /m............................................37
  305.              8.4. Option /o=...........................................37
  306.              8.4. Option /o=...........................................37
  307.  
  308.           9. OTHER VERSIONS OF ROS.....................................38
  309.           9. OTHER VERSIONS OF ROS.....................................38
  310.           9. OTHER VERSIONS OF ROS.....................................38
  311.  
  312.  
  313.  
  314.         Appendices
  315.         Appendices
  316.         Appendices
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                        ii
  324.  
  325.  
  326.  
  327.           A. CONNECTING THE MODEM......................................39
  328.           A. CONNECTING THE MODEM......................................39
  329.           A. CONNECTING THE MODEM......................................39
  330.  
  331.           B. BUILDING A NEW FILE CATALOG...............................41
  332.           B. BUILDING A NEW FILE CATALOG...............................41
  333.           B. BUILDING A NEW FILE CATALOG...............................41
  334.  
  335.           C. WARNING AND ERROR MESSAGES................................42
  336.           C. WARNING AND ERROR MESSAGES................................42
  337.           C. WARNING AND ERROR MESSAGES................................42
  338.  
  339.           D. ROS USAGE AND PROBLEM REPORT..............................45
  340.           D. ROS USAGE AND PROBLEM REPORT..............................45
  341.           D. ROS USAGE AND PROBLEM REPORT..............................45
  342.  
  343.           E. INVOICE...................................................47
  344.           E. INVOICE...................................................47
  345.           E. INVOICE...................................................47
  346.  
  347.              INDEX.....................................................48
  348.              INDEX.....................................................48
  349.              INDEX.....................................................48
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                                       iii
  397.  
  398.  
  399.  
  400.                          L I S T   O F   F I G U R E S
  401.                          L I S T   O F   F I G U R E S
  402.                          L I S T   O F   F I G U R E S
  403.                          _____________________________
  404.                          _____________________________
  405.                          _____________________________
  406.  
  407.          4-1: Hayes Modem Initialization Command String................12
  408.          4-1: Hayes Modem Initialization Command String................12
  409.          4-1: Hayes Modem Initialization Command String................12
  410.  
  411.          6-1: Sysop Sub-System.........................................21
  412.          6-1: Sysop Sub-System.........................................21
  413.          6-1: Sysop Sub-System.........................................21
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                        iv
  467.  
  468.  
  469.  
  470.                           L I S T   O F   T A B L E S
  471.                           L I S T   O F   T A B L E S
  472.                           L I S T   O F   T A B L E S
  473.                           ___________________________
  474.                           ___________________________
  475.                           ___________________________
  476.  
  477.          3-1: Files Included With ROS-PC................................3
  478.          3-1: Files Included With ROS-PC................................3
  479.          3-1: Files Included With ROS-PC................................3
  480.          3-2: Files Required for Conversion from ROS Version 3.6........3
  481.          3-2: Files Required for Conversion from ROS Version 3.6........3
  482.          3-2: Files Required for Conversion from ROS Version 3.6........3
  483.  
  484.          4-1: AREA.ROS File (split between columns 62 and 63)...........5
  485.          4-1: AREA.ROS File (split between columns 62 and 63)...........5
  486.          4-1: AREA.ROS File (split between columns 62 and 63)...........5
  487.          4-2: Positional Fields in AREA.ROS File........................5
  488.          4-2: Positional Fields in AREA.ROS File........................5
  489.          4-2: Positional Fields in AREA.ROS File........................5
  490.          4-3: Required Entries in AREA.ROS..............................6
  491.          4-3: Required Entries in AREA.ROS..............................6
  492.          4-3: Required Entries in AREA.ROS..............................6
  493.          4-4: Configuration Parameters.................................11
  494.          4-4: Configuration Parameters.................................11
  495.          4-4: Configuration Parameters.................................11
  496.          4-5: Color Scale..............................................12
  497.          4-5: Color Scale..............................................12
  498.          4-5: Color Scale..............................................12
  499.          4-6: System Message Text File.................................16
  500.          4-6: System Message Text File.................................16
  501.          4-6: System Message Text File.................................16
  502.          4-7: Files Used by ROS........................................17
  503.          4-7: Files Used by ROS........................................17
  504.          4-7: Files Used by ROS........................................17
  505.  
  506.          6-1: Format of User File Listing..............................34
  507.          6-1: Format of User File Listing..............................34
  508.          6-1: Format of User File Listing..............................34
  509.  
  510.          C-1: Error Messages...........................................44
  511.          C-1: Error Messages...........................................44
  512.          C-1: Error Messages...........................................44
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.                                        v
  555.                                ROS Sysop Manual
  556.  
  557.  
  558.         1. HISTORY AND ACKNOWLEDGMENTS
  559.         1. HISTORY AND ACKNOWLEDGMENTS
  560.         1. HISTORY AND ACKNOWLEDGMENTS
  561.  
  562.         The original SJBBS, written in Xitan Basic by Howard Moulton, was
  563.         adapted  to  MBasic by Bruce R. Ratoff.   Modifications  to  this
  564.         system  were made by Bruce Ratoff, James Underwood,  Ron  Fowler,
  565.         Brett  Berg, and many, many others.  James Whorton and  Eddie  H.
  566.         Curlin converted RBBS to Turbo Pascal (copyright Borland Interna-
  567.         tional) in 1984 and called the system TPBBS.
  568.  
  569.         ROS  version 1.0 (originally released as "TBBS23" but changed  to
  570.         "ROS" to avoid confusion with TPBBS with which it shares no code)
  571.         was written by Steven Fox using ideas gathered from these systems
  572.         and  from others operating on a wide variety of computers.   Ver-
  573.         sion  2.0 used indexed file support using B+ trees.  Version  3.0
  574.         incorporated all the communication and file transfer functions to
  575.         eliminate the need for support from programs such as "XMODEM" and
  576.         "BYE."  Though originally tied to CP/M-80, modified versions were
  577.         made to run under other operating systems.  Version 3.5 was built
  578.         to  operate under PC DOS.  Version 3.6 provided improved  archive
  579.         support as well as several new functions for the sysop.   Version
  580.         3.7  completes the archive support with the ability to type  text
  581.         files  and adds an automatic file posting system coupled  with  a
  582.         descriptive file catalog.
  583.  
  584.         ROS would not have been possible were it not for the work of  the
  585.         many individuals dedicated to making the concept of public access
  586.         telecommunications work.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.                                                                        1
  614.                                ROS Sysop Manual
  615.  
  616.  
  617.         2. MINIMUM SYSTEM
  618.         2. MINIMUM SYSTEM
  619.         2. MINIMUM SYSTEM
  620.  
  621.         ROS  version  3.7 is designed to operate on an IBM  PC,  or  very
  622.         compatible  computer, with at least 256K of memory.  Version  2.0
  623.         or  later DOS is required.  The only required support program  is
  624.         LCOMX  (see Section 4.1), though file and text  managers such  as
  625.         CWEEP, ARC and PC-WRITE are useful for some off-line  maintenance
  626.         functions.
  627.  
  628.         ROS has been tested under versions 3.1 through 3.3 of PC DOS  and
  629.         versions  3.1 and 3.2 of MS-DOS.  ROS is DESQview aware and  will
  630.         relinquish  any unneeded time to tasks running in other  windows.
  631.         Under  DESQview,  a 160k window is required.  If the  ability  to
  632.         jump to DOS is required, a 256k window is recommended.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.         2
  673.                                ROS Sysop Manual
  674.  
  675.  
  676.         3. FILES
  677.         3. FILES
  678.         3. FILES
  679.  
  680.         Table 3-1 lists the files that are included with this version  of
  681.         ROS.   Table 3-2 lists the files that are needed to  update  pre-
  682.         vious versions of ROS.
  683.  
  684.  
  685.              ROS.COM        Main executable code for ROS
  686.              ROS.000        Overlay files
  687.              ROS.001
  688.              ROS.002
  689.              ROS.003
  690.  
  691.              AREA.ROS       Sample area file
  692.              CONFIG.ROS     Sample system configuration file
  693.              MACRO.ROS      Sample macro file
  694.              SYSMTXT.ROS    Sample message file
  695.  
  696.              RO-PIF.DVP     DESQview program information file
  697.  
  698.              ROSUSR.DOC     User Guide
  699.              ROS.MAP        ROS command map
  700.              ROSSYS.DOC     System Operations Manual (this document)
  701.  
  702.              ARCHIVE.BAT    Batch file to archive the CATALOG
  703.              REMOTE.BAT     Batch file to redirect the console to COM 1
  704.              RETURN.BAT     Batch file to return control to ROS
  705.  
  706.                  Table 3-1: Files Included With ROS-PC
  707.                  Table 3-1: Files Included With ROS-PC
  708.                  Table 3-1: Files Included With ROS-PC
  709.  
  710.  
  711.  
  712.  
  713.              ROS36-37.COM   ROS file conversion utility
  714.              ROS37.NEW      Text file describing the changes to ROS
  715.  
  716.         Table 3-2: Files Required for Conversion from ROS Version 3.6
  717.         Table 3-2: Files Required for Conversion from ROS Version 3.6
  718.         Table 3-2: Files Required for Conversion from ROS Version 3.6
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                                                                        3
  736.                                ROS Sysop Manual
  737.  
  738.  
  739.         4. INSTALLING ROS
  740.         4. INSTALLING ROS
  741.         4. INSTALLING ROS
  742.  
  743.         ROS is already installed for the display on most IBM and  compat-
  744.         ible computers and does not require a graphics or color  adapter,
  745.         though it works well with CGA and EGA monitor cards.  Three  text
  746.         files  are used to match ROS to your message and file  structure,
  747.         modem, and personal preferences.
  748.  
  749.         The first of these three files, "AREA.ROS" describes the  message
  750.         and  file structure, i.e. what message and file areas are  avail-
  751.         able and what access levels are required.  "CONFIG.ROS"  contains
  752.         many  parameters to match ROS to your computer system,  including
  753.         the  modem  and a color monitor, if available.  The  third  file,
  754.         "SYSMTXT.ROS"  is the system message file.  It contains the  mes-
  755.         sages,  bulletins,  and  menus sent to the  user  during  various
  756.         stages  of operation.  Each file is described in more  detail  in
  757.         the following sections.
  758.  
  759.         4.1. Configuring DOS
  760.         4.1. Configuring DOS
  761.  
  762.         Two  changes  should be made to your system, the  first  to  your
  763.         CONFIG.SYS file and the second to your AUTOEXEC.BAT (please refer
  764.         to your DOS manual for more information about these two files).
  765.  
  766.              CONFIG.SYS
  767.  
  768.         Include the statement "FILES = 20" in your CONFIG.SYS file.  This
  769.         will allow ROS to open all the files it needs to operate.  If you
  770.         already  have a "FILES" statement with a value greater  than  20,
  771.         you don't need to change it.  Please refer to your DOS manual for
  772.         more  information about the CONFIG.SYS file (not to  be  confused
  773.         with the CONFIG.ROS file).
  774.  
  775.              AUTOEXEC.BAT
  776.  
  777.         LCOMX.EXE provides ROS with the interrupt driven interface to the
  778.         communication port.  LCOMX.EXE is a memory resident utility  that
  779.         need to be run only once after the computer is booted, regardless
  780.         of  how  many  times ROS is run.  The  simplest  approach  is  to
  781.         include "LCOMX" in your AUTOEXEC.BAT file.  Remember, LCOMX  must
  782.                                                                      ____
  783.         be run before ROS.
  784.                ______
  785.  
  786.         4.2. Message and file area control file - AREA.ROS
  787.         4.2. Message and file area control file - AREA.ROS
  788.  
  789.         The  message  and  file area control file, AREA.ROS  is  used  to
  790.         control  access to specific file and message areas.  A sample  of
  791.         the area file is shown in table 4-1.  Table 4-2 lists each  field
  792.         and the field positions.
  793.  
  794.         The  entries shown in the table 4-1 are expected by ROS and  must
  795.         be  present in the area file.  The message area for POST and  the
  796.  
  797.  
  798.         4
  799.                                ROS Sysop Manual
  800.  
  801.  
  802.         directory path to LOGIN and NEWIN may be changed to any value and
  803.         the access levels for these entries may also be set to any value.
  804.         Table 4-3 describes each of these entries in more detail.
  805.  
  806.  
  807.         Column   1         2         3         4         5         6
  808.         12345678901234567890123456789012345678901234567890123456789012
  809.  
  810.         MAIL        Mail and messages addressed to you
  811.         SENT        Mail and messages you have sent
  812.         WORLD       Public messages from all areas
  813.         SYSTEM      System wide message access
  814.         POST        Trading Post - Buy, Sell, Trade
  815.         LOGIN       Login area
  816.         NEWIN       ** New uploads **
  817.  
  818.  
  819.              Column   7
  820.                3456789012345678
  821.  
  822.                 10   0
  823.                 10   0
  824.                 10   0
  825.                255   0
  826.                 10   1
  827.                 10 C:\ROS\LOGIN
  828.                 20 C:\ROS\NEWIN
  829.  
  830.  
  831.         Table 4-1: AREA.ROS File (split between columns 62 and 63)
  832.         Table 4-1: AREA.ROS File (split between columns 62 and 63)
  833.         Table 4-1: AREA.ROS File (split between columns 62 and 63)
  834.  
  835.  
  836.  
  837.  
  838.              Area name                   1-12
  839.              Area description            13-62
  840.              Access level required       63-65
  841.              Must be blank               66
  842.              DOS directory path, or      67-131
  843.              Message area number
  844.  
  845.  
  846.             Table 4-2: Positional Fields in AREA.ROS File
  847.             Table 4-2: Positional Fields in AREA.ROS File
  848.             Table 4-2: Positional Fields in AREA.ROS File
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.                                                                        5
  860.                                ROS Sysop Manual
  861.  
  862.  
  863.            MAIL     When the user logs into this message area, ROS will
  864.                     build a list of the mail addressed to that user.  The
  865.                     message area number should be "0" and the access
  866.                     level should be set low enough that unvalidated users
  867.                     have access.
  868.  
  869.            SENT     This message area is used to access messages and mail
  870.                     the user has sent.  The message area number and
  871.                     access level should be set as in "MAIL."
  872.  
  873.            WORLD    This is not a single message area but a cross-section
  874.                     of the various message areas to which the user has
  875.                     access, not including "MAIL" and "SENT."  The access
  876.                     level is ignored.  Instead, ROS uses the access level
  877.                     for each individual message area to determine if the
  878.                     user has access to a message.  The message area
  879.                     number should be "0."
  880.  
  881.            SYSTEM   This message area is special since ALL mail and
  882.                     messages, regardless of the sender and addressee,
  883.                     (including those that have been deleted but not yet
  884.                     purged) will be included.  THE ACCESS LEVEL OF THIS
  885.                     AREA SHOULD BE SET HIGH ENOUGH THAT NORMAL USERS DO
  886.                     NOT HAVE ACCESS.  The access level defined for
  887.                     "AltSysop" (see CONFIG.ROS) is recommended.
  888.  
  889.            POST     This is the message area that every user "sees"
  890.                     initially.  The access level should be set low enough
  891.                     that new users have access on their first call ("0"
  892.                     is recommended).
  893.  
  894.            LOGIN    This is the file area that every user "sees"
  895.                     initially.  The access level should be set low enough
  896.                     that new users have access on their first call ("0"
  897.                     is recommended).
  898.  
  899.            NEWIN    This is the file area into which uploads will be
  900.                     placed.  The access level of this area may be any
  901.                     value.
  902.  
  903.  
  904.                 Table 4-3: Required Entries in AREA.ROS
  905.                 Table 4-3: Required Entries in AREA.ROS
  906.                 Table 4-3: Required Entries in AREA.ROS
  907.  
  908.  
  909.         NOTE: AREA.ROS should NOT have extra lines after the last line of
  910.         information.   In  addition, unlike the system message  file  de-
  911.         scribed in section 4.4, ROS cannot process high-order bits in the
  912.         text  of this file, so an editor must be used which does not  use
  913.         these bits.  WordStar, in non-document mode, or other  commercial
  914.         and public-domain editors may be used.
  915.  
  916.  
  917.  
  918.         6
  919.                                ROS Sysop Manual
  920.  
  921.  
  922.         4.3. ROS configuration file - CONFIG.ROS
  923.         4.3. ROS configuration file - CONFIG.ROS
  924.  
  925.         Table 4-4 lists the parameters which tailor ROS for your  system.
  926.         These parameters should be consolidated into the file  CONFIG.ROS
  927.         which  will be interpreted during the initial startup.  The  file
  928.         consists  of entries with two components: the parameter  and  the
  929.         value.  In addition, comments, starting with a semi-colon  (";"),
  930.         may  be freely included in the file.  If a parameter is  not  in-
  931.         cluded in the file, or if the file is not found, ROS will use the
  932.         listed default value.
  933.  
  934.         Remember, it is not necessary to include all of these entries  in
  935.         CONFIG.ROS, only those that are different from the listed default
  936.         values.   In fact, the fewer entries there area, the  faster  ROS
  937.         will start.
  938.  
  939.  
  940.            Parameter      Default        Notes
  941.            ___________________________________
  942.  
  943.            SysName        ROS            Name to be listed in the system
  944.                                          directory.
  945.            HDPark         0              Number of hard disk drives to
  946.                                          park (seek to an unused track)
  947.                                          when waiting for a caller.  "0"
  948.                                          inhibits the park function.  "1"
  949.                                          or "2" are other allowable
  950.                                          values.
  951.            TimeoutShort   60             Short time-out in seconds.  This
  952.                                          is the period allowed callers to
  953.                                          complete their login and the
  954.                                          length of time to wait for a
  955.                                          keystroke during the login
  956.                                          process.  Since many users will
  957.                                          set their modem on auto-dial and
  958.                                          leave, it does not need to be
  959.                                          very long.
  960.            TimeoutLong    300            Long timeout in seconds.  This
  961.                                          is the period ROS will wait for
  962.                                          a keystroke once the user has
  963.                                          completed the login process.
  964.            DefAcc         10             New user access level.  This is
  965.                                          the access level assigned to
  966.                                          first-time callers.
  967.            RegAcc         11             Registered user access level.
  968.                                          This is the access level
  969.                                          assigned to the user when the
  970.                                          registration information is
  971.                                          completed.  ROS does not check
  972.                                          for content during the regi-
  973.                                          stration process, only that the
  974.                                          user at least tried.
  975.  
  976.  
  977.                                                                        7
  978.                                ROS Sysop Manual
  979.  
  980.  
  981.            ValAcc         20             Validated user access level.
  982.                                          This is the access level
  983.                                          assigned when the <V>alidate
  984.                                          user command is selected from
  985.                                          the sysop sub-system.
  986.            DirAcc         20             System directory access level.
  987.                                          File areas with this access
  988.                                          level or lower will be included
  989.                                          in the system directory.
  990.                                          Normally this will be the same
  991.                                          as "ValAcc" (above) but there
  992.                                          may be special situations which
  993.                                          require this flexibility.
  994.            AltSysop       250            Alternate sysop access level.
  995.                                          Users with this access level or
  996.                                          higher can perform any operation
  997.                                          on the system except <C>opy and
  998.                                          <D>elete files in the sysop sub-
  999.                                          system.
  1000.            PriSysop       255            Primary sysop access level.
  1001.                                          Users with this access level or
  1002.                                          higher (255 is the limit) can do
  1003.                                          anything on the system.
  1004.            LPDAcc         250            The time limit is per day for
  1005.                                          users below this access level.
  1006.                                          At or above this level, the
  1007.                                          limit is per call.
  1008.            DefTime        15             Default time limit.  This is the
  1009.                                          time allotted first time
  1010.                                          callers.
  1011.            ValTime        45             Time limit for validated users.
  1012.                                          When users are validated, their
  1013.                                          access level will be increased
  1014.                                          to this value.
  1015.            DefChars       80             Default characters per line.
  1016.                                          This value will be inserted in
  1017.                                          the user record as the number of
  1018.                                          characters per line.  The user
  1019.                                          can change this value in the
  1020.                                          Utility sub-system.
  1021.            DefLines       23             Default lines per page.  Similar
  1022.                                          to "DefChars."
  1023.            DefMsgArea     POST           Default message area.  Until
  1024.                                          changed by the user, this will
  1025.                                          be the message area they first
  1026.                                          see when calling the system.
  1027.            DefFilArea     LOGIN          Default file area.  Similar to
  1028.                                          "DefMsgArea."
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.         8
  1035.                                ROS Sysop Manual
  1036.  
  1037.  
  1038.            ChatStart      19             Chat period start time.  From
  1039.                                          this hour (24 hour clock) until
  1040.                                          "ChatEnd" ROS will signal the
  1041.                                          sysop by ringing the console
  1042.                                          bell when the user requests chat
  1043.                                          from the Utility sub-system.
  1044.                                          During other hours, ROS will
  1045.                                          just offer to save a message.
  1046.            ChatEnd        22             Chat period ending time.
  1047.            ChatSignals    10             Number of times to signal local
  1048.                                          console.  Each attempt takes
  1049.                                          approximately 6 seconds.
  1050.            Fence          |              Character between directory
  1051.                                          columns.  It can be any
  1052.                                          printable character, including a
  1053.                                          blank (" ").
  1054.            UnvDays        7              Days to retain unvalidated user.
  1055.                                          When the sysop function to
  1056.                                          <P>urge users is selected, ROS
  1057.                                          will delete all unvalidated
  1058.                                          users that have not called the
  1059.                                          system in "UnvDays."
  1060.            ValDays        180            Days to retain validated users.
  1061.                                          Similar to "UnvDays" but for
  1062.                                          validated users.  For more
  1063.                                          information, refer to the sysop
  1064.                                          <P>urge command.
  1065.            ReadDays       10             Days to retain read, undeleted
  1066.                                          mail (private messages).  Mail
  1067.                                          that has been read but not
  1068.                                          deleted will be purged this
  1069.                                          number of days after entry.
  1070.            UnrdDays       90             Days to retain unread, undeleted
  1071.                                          messages.  Any message, public
  1072.                                          or private, will be purged this
  1073.                                          number of days after entry.
  1074.            NewinDays      14             Days since upload (or creation)
  1075.                                          to retain files in the NEWIN
  1076.                                          file area
  1077.            DustyDays      30             Days since last download to
  1078.                                          retain files in the DUSTY file
  1079.                                          area
  1080.            OtherDays      180            Days since last download to
  1081.                                          retain files in other areas
  1082.            MaxTries       3              Maximum number of tries for
  1083.                                          password.  If the user cannot
  1084.                                          enter their password in
  1085.                                          "MaxTries" attempts, ROS will
  1086.                                          offer to leave a message and
  1087.                                          then disconnect.
  1088.  
  1089.  
  1090.  
  1091.                                                                        9
  1092.                                ROS Sysop Manual
  1093.  
  1094.  
  1095.            OpenSystem     Y              The default, an open system,
  1096.                                          will allow new users to enter a
  1097.                                          password and receive limited
  1098.                                          access.  When logging out, ROS
  1099.                                          will ask them to register for
  1100.                                          more access.  A closed system
  1101.                                          will refuse access to new users.
  1102.                                          The sysop MUST preload the user
  1103.                                          with the associated password
  1104.                                          before the system will recognize
  1105.                                          him.
  1106.  
  1107.            TrimHiBit      Y              Text may either be stripped to
  1108.                                          seven bit characters or left
  1109.                                          alone.  If a text editor, such
  1110.                                          as WordStar in document mode, is
  1111.                                          used for SYSMTXT.ROS, "Y" should
  1112.                                          be used to prevent sending non-
  1113.                                          ASCII characters.  If eight-bit
  1114.                                          graphics characters are desired,
  1115.                                          "N" should be selected.
  1116.            ComPort        1              Port to be used for all modem
  1117.                                          I/O (either "1" or "2" may be
  1118.                                          used).
  1119.            ComParity      N              Parity to set port.  The
  1120.                                          following characters may be
  1121.                                          used:
  1122.                                            "N" => None
  1123.                                            "E" => Even
  1124.                                            "O" => Odd
  1125.            ComLength      8              Number of bits in characters to
  1126.                                          be received and transmitted.
  1127.            ComStop        1              Number of stop bits in each
  1128.                                          character.
  1129.            CmndReset      AT Z{          Modem reset string - sent at
  1130.                                          startup and connect failures.
  1131.            RespReset      OK             Expected response string from
  1132.                                          modem to indicate successful
  1133.                                          reset.
  1134.            WaitReset      5              Seconds to wait before assuming
  1135.                                          failure.
  1136.            CmndInit       AT E1 H0 Q0 S0=0 S7=30 V1 X4 M0{
  1137.                                          Modem initialization string -
  1138.                                          sent before EACH call to ensure
  1139.                                          the modem is ready for the next
  1140.                                          call.
  1141.            RespInit       OK             Response if successful.
  1142.            WaitInit       5              Seconds to wait for success.
  1143.            CmndBusy       AT H1{         Make line busy.
  1144.            RespBusy       OK             Response if successful.
  1145.            WaitBusy       5              Seconds to wait for success.
  1146.  
  1147.  
  1148.         10
  1149.                                ROS Sysop Manual
  1150.  
  1151.  
  1152.            CmndLocal      ~~~+++         Return modem to local mode
  1153.                                          (escape code).
  1154.            RespLocal      OK             Response if successful.
  1155.            WaitLocal      5              Seconds to wait for success.
  1156.            CmndHangup     AT H{          Disconnect - hang-up.
  1157.            RespHangup     OK             Response if successful.
  1158.            WaitHangup     5              Seconds to wait for success.
  1159.            RespRing       RING           Ring signal detected.
  1160.            CmndAnswer     AT A{          Answer call - pick up phone.
  1161.            RespAnswer                    Response if successful.
  1162.            WaitAnswer     5              Seconds to wait for success.
  1163.  
  1164.            RespConnect    CONNECT 2400   Connect message.  This is the
  1165.                                          first of seven baud rates
  1166.                                          supported by ROS.  In addition
  1167.                                          to being used for communication
  1168.                                          with remote users, it will be
  1169.                                          used for off-line communication
  1170.                                          with your modem and should
  1171.                                          usually be the fastest speed the
  1172.                                          modem can handle.
  1173.            RateConnect    2400           Rate to set the communications
  1174.                                          port when this message is
  1175.                                          received from the modem.
  1176.            RespConnect    CONNECT 1200   Connect message.
  1177.            RateConnect    1200           Rate to set for this message.
  1178.            RespConnect    CONNECT        Connect message.
  1179.            RateConnect    300            Rate to set for this message.
  1180.            WaitConnect    15             Seconds to wait for connect
  1181.                                          message.
  1182.            RespError      ERROR          Error in command execution.
  1183.                                          This is the message sent by the
  1184.                                          modem when an error is detected.
  1185.            BGMain         0              Main window background color
  1186.                                          (see table 4-5 for the color
  1187.                                          scale)
  1188.            FGMain         7              Main window character color
  1189.            BGStat         7              Status window background color
  1190.            FGStat         0              Status window character color
  1191.            BGSend         0              Send window background color
  1192.            FGSend         7              Send window character color
  1193.            BGRecv         0              Receive window background color
  1194.            FGRecv         7              Receive window character color
  1195.  
  1196.  
  1197.                   Table 4-4: Configuration Parameters
  1198.                   Table 4-4: Configuration Parameters
  1199.                   Table 4-4: Configuration Parameters
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.                                                                        11
  1208.                                ROS Sysop Manual
  1209.  
  1210.  
  1211.         In the modem command strings described in table 4-4, a left brace
  1212.         ("{")  is used to send a carriage return to the modem.   A  tilde
  1213.         ("~")  causes  a  delay for 1/2 second  before  continuing.   For
  1214.         example, "~~~+++" delays for 1 1/2 seconds, and then sends  "+++"
  1215.         to  the modem.  Command strings may be up to 50  characters  long
  1216.         (though  most modems only allow 40 characters not  including  the
  1217.         prefix "AT," spaces, or the carriage return), responses may be as
  1218.         long as 16 characters.
  1219.  
  1220.         The   modem  initialization  string  listed  in  table  4-4   for
  1221.         "CmndInit" works well with "real" Hayes modems.  Figure 4-1 gives
  1222.         a description of each element in the string.
  1223.  
  1224.              |get modem's attention
  1225.              |  |modem should echo characters when off-line
  1226.              |  |  |ensure phone hung up
  1227.              |  |  |  |return result codes ("Resp---")
  1228.              |  |  |  |  |disable auto answer
  1229.              |  |  |  |  |    |wait 30 seconds for carrier
  1230.              |  |  |  |  |    |     |verbose (words) result codes
  1231.              |  |  |  |  |    |     |  |enable extended command set
  1232.              |  |  |  |  |    |     |  |  |turn off the speaker
  1233.              |  |  |  |  |    |     |  |  | |command terminator
  1234.              AT E1 H0 Q0 S0=0 S7=30 V1 X4 M0{
  1235.  
  1236.           Fig. 4-1: Hayes Modem Initialization Command String
  1237.           Fig. 4-1: Hayes Modem Initialization Command String
  1238.           Fig. 4-1: Hayes Modem Initialization Command String
  1239.  
  1240.  
  1241.         Some  modems  respond  with "OFF HOOK" when  issued  the  command
  1242.         "ATA".  Those that do may need the following definition:
  1243.  
  1244.         RespAnswer     OFF HOOK      Response if successful
  1245.  
  1246.  
  1247.              0  Black            8  Dark Gray
  1248.              1  Blue             9  Light Blue
  1249.              2  Green           10  Light Green
  1250.              3  Cyan            11  Light Cyan
  1251.              4  Red             12  Light Red
  1252.              5  Magenta         13  Light Magenta
  1253.              6  Brown           14  Yellow
  1254.              7  Light Gray      15  White
  1255.  
  1256.                          Table 4-5: Color Scale
  1257.                          Table 4-5: Color Scale
  1258.                          Table 4-5: Color Scale
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.         12
  1269.                                ROS Sysop Manual
  1270.  
  1271.  
  1272.         4.4. System message file - SYSMTXT.ROS
  1273.         4.4. System message file - SYSMTXT.ROS
  1274.  
  1275.         SYSMTXT.ROS, the system message file, should be created for  your
  1276.         particular system.  A sample file is included as a guideline.
  1277.  
  1278.         ROS  can process SYSMTXT.ROS files created by text editors  which
  1279.         use  the  high bit of characters, such as  WordStar  in  document
  1280.         mode.  When ROS is started, it looks for SYSMIDX.ROS.  If  found,
  1281.         it  will  be used as an index into the text file.  If it  is  not
  1282.         found,  ROS  will create it from SYSMTXT.ROS.   When  you  change
  1283.         SYSMTXT.ROS,  ROS will detect the changes and  automatically  re-
  1284.         build SYSMIDX.ROS.
  1285.  
  1286.         Since  many  messages are used during operation,  SYSMTXT.ROS  is
  1287.         divided into sections.  Each section starts with a colon (":") in
  1288.         column one, followed by a unique two character identifier.  Table
  1289.         4-6 describes each entry in this file.
  1290.  
  1291.  
  1292.              :WM       Welcome text
  1293.  
  1294.                        This text is displayed to the user before the
  1295.                        system asks for the user's name.
  1296.  
  1297.              :GM       Goodbye text
  1298.  
  1299.                        This is the text displayed just before the system
  1300.                        disconnects.
  1301.  
  1302.              :B0       Bulletin automatically displayed at login
  1303.  
  1304.                        This is the text displayed after the user logs
  1305.                        into the system and when "B" is selected while in
  1306.                        the message system.
  1307.  
  1308.              :B1-:B9   User selected bulletins
  1309.  
  1310.                        These are the texts displayed when the user
  1311.                        presses "1" - "9."
  1312.  
  1313.              :OS       Other systems
  1314.  
  1315.                        This is the text displayed when the user selects
  1316.                        "O" while in the message system.
  1317.  
  1318.              :NF       Name search failed
  1319.  
  1320.                        If ROS cannot find the user name, this text will
  1321.                        be displayed.
  1322.                        Open systems: old users should be asked to try
  1323.                        again, new users will be told that they can
  1324.  
  1325.  
  1326.                                                                        13
  1327.                                ROS Sysop Manual
  1328.  
  1329.  
  1330.                        register on-line.
  1331.                        Closed systems: this text will be the last thing
  1332.                        an unauthorized user will see.  You may leave this
  1333.                        completely blank or tell the user what he has to
  1334.                        do to register.
  1335.  
  1336.              :PF       Password match failed
  1337.  
  1338.                        If the user enters an incorrect password, this
  1339.                        text will be displayed.
  1340.  
  1341.              :IN       Information for new users
  1342.  
  1343.                        This text will be displayed the first time a user
  1344.                        calls and whenever "I" is selected while in the
  1345.                        message system.
  1346.  
  1347.              :RR       Registration request
  1348.  
  1349.                        This text will be displayed if the unregistered
  1350.                        user selects "R" while in the utility system or if
  1351.                        he answers yes to the registration question.
  1352.  
  1353.              :AR       Transfer from within an archive
  1354.  
  1355.                        When a user starts to transfer a file from within
  1356.                        an archive, this text will be displayed.
  1357.  
  1358.              :UD       Upload description
  1359.  
  1360.                        After a successful upload, this text will be
  1361.                        displayed.
  1362.  
  1363.              :HM     * Help for message sub-system
  1364.  
  1365.                        This is the message sub-system help menu.
  1366.  
  1367.              :HF     * Help for file sub-system
  1368.  
  1369.                        This is the file sub-system help menu.
  1370.  
  1371.              :HU     * Help for utility sub-system
  1372.  
  1373.                        This is the utility sub-system help menu.
  1374.  
  1375.              :HC     * Help for system configuration
  1376.  
  1377.                        This menu will be displayed when the user selects
  1378.                        "A" while in the utility system.
  1379.  
  1380.  
  1381.  
  1382.  
  1383.         14
  1384.                                ROS Sysop Manual
  1385.  
  1386.  
  1387.              :HS     * Help for sysop Sub-system
  1388.  
  1389.                        This is the sysop system help menu.
  1390.  
  1391.              :HE     * Help for editing text
  1392.  
  1393.                        This text will be displayed when the user edits a
  1394.                        message or when the sysop edits a macro.
  1395.  
  1396.              :HT       Help for transfer mode selection
  1397.  
  1398.                        This text will be displayed when the user changes
  1399.                        the file transfer mode.
  1400.  
  1401.              :HP     * Help for purge file command
  1402.  
  1403.                        This text will be displayed to the sysop when
  1404.                        purging files.
  1405.  
  1406.              :HL     * Help for list file command
  1407.  
  1408.                        This text will be displayed to the sysop when
  1409.                        listing system files.
  1410.  
  1411.              :HR     * Help for edit user record
  1412.  
  1413.                        This text will be displayed when editing user
  1414.                        records.
  1415.  
  1416.              :HA     * Help for alter message status
  1417.  
  1418.                        This text will be displayed when changing the
  1419.                        status of messages.
  1420.  
  1421.              :HN     * Help for catalog file status changes
  1422.  
  1423.                        This text will be displayed to the sysop when
  1424.                        changing the status (hidden, released, etc.) of
  1425.                        files in the catalog.
  1426.  
  1427.              :HI     * Help for information displayed during user listing
  1428.  
  1429.                        This text will be displayed to the sysop when
  1430.                        listing users.
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.                                                                        15
  1441.                                ROS Sysop Manual
  1442.  
  1443.  
  1444.              :HY     * Help for catalog system
  1445.  
  1446.                        This text will be displayed to the sysop when
  1447.                        using the catalog system.
  1448.  
  1449.              :HZ     * Help for catalog record editor
  1450.  
  1451.                        This text will be displayed to the sysop when
  1452.                        making changes to the catalog entries.
  1453.  
  1454.         *  automatic display if the current help level is  3.   Otherwise
  1455.         available by pressing "?" when in the associated context.
  1456.  
  1457.              Table 4-6: System Message Text File
  1458.              Table 4-6: System Message Text File
  1459.              Table 4-6: System Message Text File
  1460.  
  1461.         4.5. Other files used by ROS
  1462.         4.5. Other files used by ROS
  1463.  
  1464.         When the area, configuration, and system message files are ready,
  1465.         ROS  can  be started.  If it cannot find the other files  it  ex-
  1466.         pects,  it will create them.  Table 4-7 lists the files ROS  uses
  1467.         and a brief description of their functions.
  1468.  
  1469.              AREA.ROS      See section 4.2 for a complete description
  1470.  
  1471.              CONFIG.ROS    See section 4.3 for a complete description
  1472.  
  1473.              SYSMTXT.ROS   See section 4.4 for a complete description
  1474.  
  1475.              SYSMIDX.ROS   Index file into SYMSTXT.ROS.
  1476.  
  1477.              LOG.ROS       Log of activities on the system.
  1478.  
  1479.              MACRO.ROS     This is a text file that may be edited outside
  1480.                            of ROS or with the macro functions in the
  1481.                            sysop sub-system.  Since most communication
  1482.                            packages now include scripts, macros, or the
  1483.                            equivalent, ROS only supports this feature for
  1484.                            the sysop.
  1485.  
  1486.              MESSAGE.ROS   This file contains the text of messages and
  1487.                            mail.
  1488.  
  1489.              SUMMARY.ROS   This file contains the header and subject
  1490.                            information for the messages and mail.
  1491.  
  1492.              CATDAT.ROS    This file contains the descriptions and other
  1493.                            statistical information for all files on the
  1494.                            system.  Portions of this file are displayed
  1495.                            with the <D>irectory command in the file sub-
  1496.                            system.  It is edited with the <C>atalog
  1497.                            command in the sysop sub-system.
  1498.  
  1499.  
  1500.         16
  1501.                                ROS Sysop Manual
  1502.  
  1503.  
  1504.  
  1505.              CATNNDX.ROS   These files provide fast access to the catalog
  1506.              CATDNDX.ROS   file (CATDAT.ROS).
  1507.  
  1508.              STATS.ROS     This file contains the counters used by ROS to
  1509.                            keep track of users, callers, time usage, etc.
  1510.  
  1511.              USERDAT.ROS   These are the user records.  To conserve disk
  1512.                            space, "SUMMARY.ROS", "CATDAT.ROS", and
  1513.                            "LOG.ROS" maintain pointers into this file
  1514.                            instead of storing the entire user name.
  1515.  
  1516.              USERIDX.ROS   This is the index file into USERDAT.ROS.
  1517.  
  1518.                       Table 4-7: Files Used by ROS
  1519.                       Table 4-7: Files Used by ROS
  1520.                       Table 4-7: Files Used by ROS
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.                                                                        17
  1560.                                ROS Sysop Manual
  1561.  
  1562.  
  1563.         5. USING THE SYSTEM
  1564.         5. USING THE SYSTEM
  1565.         5. USING THE SYSTEM
  1566.  
  1567.         ROS expects to find all files in the file area (sub-directory) in
  1568.         which it first starts.  It is here that the user files, log file,
  1569.         etc. will be maintained.  Since ROS provides the sysop with  full
  1570.         control  over who has access to this area through  access  level,
  1571.         two methods protect the ROS system files from users:
  1572.  
  1573.              1.  do not include this area in the AREA.ROS file, or
  1574.              2.  set the access level of this area sufficiently high,
  1575.                  such as 250 or higher.
  1576.  
  1577.         In  a similar manner, other private areas of the disk system  can
  1578.         be protected from users.  In the example AREA.ROS file,  "ROSRUN"
  1579.         can  only  be accessed by the sysop.  Other users will  not  even
  1580.         know the area exists.
  1581.  
  1582.         5.1. Logging in the first time
  1583.         5.1. Logging in the first time
  1584.  
  1585.         When  you  run ROS the first time, it will create  the  files  it
  1586.         needs.  ROS will signon and let you know what files it is  making
  1587.         and  then get the modem ready.  When the message  "ROS  ready..."
  1588.         appears  on  the status line, ROS is in an idling  state  and  is
  1589.         ready for one of two actions:
  1590.  
  1591.              1. a signal from the modem indicating an incoming call, or
  1592.              2. a command from the console indicating a local user.
  1593.  
  1594.         To  log in locally, press the carriage return (refer  to  section
  1595.         5.4.1  for  additional  information).  After  the  "FIRST  name>"
  1596.         prompt  appears,  enter "SYSOP" as your first name.   This  is  a
  1597.         special name ROS recognizes and will inhibit display of the "LAST
  1598.         name>" prompt.  Since this is the first time you have been on the
  1599.         system,  ROS  will  prompt for a password -  enter  one  of  your
  1600.         choice.   You are now logged into the system.  As the sysop,  you
  1601.         are  automatically  assigned  an  access  level  as  defined   in
  1602.         CONFIG.ROS by "PriSysop" and an access time defined by "ValTime."
  1603.  
  1604.              CAUTION: It is very important that you log in using  the
  1605.              name  "sysop"  before making the  system  available  for
  1606.              others  to  use.  Since there are folks out  there  that
  1607.              will  try to log in as sysop, if you have not  set  your
  1608.              password, they will set it for you and will consequently
  1609.              have full sysop level access!
  1610.  
  1611.         5.2. Status line
  1612.         5.2. Status line
  1613.  
  1614.         When  a user is logged into ROS, a status line of  the  following
  1615.         form will be displayed:
  1616.  
  1617.         Rate | Time on-Time left | Access level | Name | City, State
  1618.  
  1619.  
  1620.         18
  1621.                                ROS Sysop Manual
  1622.  
  1623.  
  1624.  
  1625.         5.3. When ROS is idling between users
  1626.         5.3. When ROS is idling between users
  1627.  
  1628.         When ROS is idling, i.e. waiting for a call, the CRT screen  will
  1629.         be cleared and a time of day clock will be displayed to  indicate
  1630.         that ROS is operational.  This clock will invert its colors every
  1631.         two seconds to ensure there is no chance of screen burn.
  1632.  
  1633.         5.4. Local console commands
  1634.         5.4. Local console commands
  1635.  
  1636.         The local console has several commands, entered by function keys,
  1637.         that  may be used while the system is idling and while a user  is
  1638.         logged  in remotely.  In either condition, pressing function  key
  1639.         "F1"  will display a list of the commands that ROS  will  accept.
  1640.         If ROS is idling, pressing this key will display the following on
  1641.         the status line:
  1642.  
  1643.         F10: Shutdown, C/R: Local use
  1644.  
  1645.         If  the  command line parameter "/d" was included  when  ROS  was
  1646.         started, the following will be displayed instead:
  1647.  
  1648.         F2: Direct, F10: Shutdown, C/R: Local use
  1649.  
  1650.         If  a user is logged on remotely, pressing "F1" will display  the
  1651.         following on the status line:
  1652.  
  1653.         F3: Delay, F4: Remote, F5: Chat, F6: Signal, F9: Twit
  1654.  
  1655.         Since  no function key commands are available when logged  in  at
  1656.         the local console, pressing "F1" while in this mode will have  no
  1657.         effect.   Each  of these commands is described in  the  following
  1658.         sections.
  1659.  
  1660.         5.4.1. C/R  Using ROS locally
  1661.         5.4.1. C/R  Using ROS locally
  1662.  
  1663.              When ROS is idling, pressing the C/R ("Enter") key will take
  1664.              the modem off hook and allow you to proceed as if you were a
  1665.              remote caller.  All operations except file transfer are
  1666.              available.  In this mode, ROS will assume a connect rate as
  1667.              specified by the first "RateConnect" entry in the CONFIG.ROS
  1668.              file when displaying file transfer times in a file
  1669.              directory.
  1670.  
  1671.         5.4.2. F2   Direct connection
  1672.         5.4.2. F2   Direct connection
  1673.  
  1674.              When started with the "/d" command line parameter, ROS will
  1675.              bypass normal modem commands to allow high-speed direct
  1676.              connection to another computer.  This command initiates the
  1677.              connection at the rate specified by the first "RateConnect"
  1678.              entry in the CONFIG.ROS file.
  1679.  
  1680.  
  1681.                                                                        19
  1682.                                ROS Sysop Manual
  1683.  
  1684.  
  1685.  
  1686.         5.4.3. F3   Delayed disable
  1687.         5.4.3. F3   Delayed disable
  1688.  
  1689.              This command toggles the system disable function so that
  1690.              when the current user logs out, the modem will be made busy
  1691.              and the the bell will be sounded to indicate that ROS avail-
  1692.              able for local use.  The function is helpful in getting
  1693.              control of a busy system.  While the user is still logged
  1694.              in, this command may be used to alternately turn the func-
  1695.              tion on and off.
  1696.  
  1697.         5.4.4. F4   Disable remote I/O
  1698.         5.4.4. F4   Disable remote I/O
  1699.  
  1700.              This command alternately disables and re-enables the output
  1701.              to the remote system.  Disabling the remote I/O is useful
  1702.              since local operations can proceed at full speed without
  1703.              waiting for the relatively slow modem.  With the remote I/O
  1704.              disabled, the access level of the system is temporarily set
  1705.              to "AltSysop" level.  When remote I/O is restored, the ac-
  1706.              cess level is reinstated to its original value.  The in-
  1707.              creased access level is convenient to validate users while
  1708.              they are still logged in, move files that the user could not
  1709.              otherwise get to, etc.
  1710.  
  1711.         5.4.5. F5   Sysop initiated CHAT
  1712.         5.4.5. F5   Sysop initiated CHAT
  1713.  
  1714.              ROS will issue a message to the remote user and then enter
  1715.              the chat mode.  This command bypasses the time-of-day checks
  1716.              and may be entered at any time (chat hours are restricted to
  1717.              users).
  1718.  
  1719.         5.4.6. F6   Signal key
  1720.         5.4.6. F6   Signal key
  1721.  
  1722.              This command turns off the chat signal without any indica-
  1723.              tion to the user.
  1724.  
  1725.         5.4.7. F9   Twit key
  1726.         5.4.7. F9   Twit key
  1727.  
  1728.              This command will cause ROS to immediately hang up on the
  1729.              remote user.  While the F3 command is preferred to gain
  1730.              system access, this command is sometimes necessary.
  1731.  
  1732.         5.4.8. Shutdown ROS
  1733.         5.4.8. Shutdown ROS
  1734.  
  1735.         F10  When ROS is idling, entering this command will terminate ROS
  1736.              operation and return control to the operating system.  ROS
  1737.              will first ask if the modem should be taken off the hook to
  1738.              present a busy signal to users.  This is useful when the
  1739.              system will be down for a short time.
  1740.  
  1741.  
  1742.  
  1743.  
  1744.         20
  1745.                                ROS Sysop Manual
  1746.  
  1747.  
  1748.         6. MAINTENANCE
  1749.         6. MAINTENANCE
  1750.         6. MAINTENANCE
  1751.  
  1752.         The sysop(s) should regularly use ROS to read mail, validate  new
  1753.         users, and release (or not) the new files uploaded to the system.
  1754.         A  check  may also be made of other messages and mail  to  ensure
  1755.         that  they are appropriate to the philosophy of the system.   Be-
  1756.         ware  of  messages and mail which contain  credit  card  numbers,
  1757.         computer access codes, or other sensitive information.
  1758.  
  1759.         Since the message file only marks messages as deleted, it  should
  1760.         be compressed periodically.  A good way to do this is to turn  on
  1761.         the  printer or the audit trail, list the log and message  files,
  1762.         then turn the printer off and purge the files.  This way, a hard-
  1763.         copy record is kept of all activity on the system.
  1764.  
  1765.         Not re-using the message space was a conscious design decision to
  1766.         allow the sysop to maintain a history of ALL messages entered  on
  1767.         the system.  The events surrounding MOGUR demonstrate the need.
  1768.  
  1769.         6.1. Sysop Sub-system
  1770.         6.1. Sysop Sub-system
  1771.  
  1772.         The sysop command system is accessed by typing "X" at a  message,
  1773.         file, or utility command sub-system prompt.  This command is  not
  1774.         available  to  users  below  the  alternate  sysop  access  level
  1775.         ("AltSysop" is defined in CONFIG.ROS).
  1776.  
  1777.         Figure 6-1 lists the sysop sub-system commands.  This menu may be
  1778.         displayed  at  any  time by entering "?"  (without  the  quotes).
  1779.         Subsequent sections describe each command in detail.
  1780.  
  1781.  
  1782.                                 Sysop Sub-System
  1783.  
  1784.         =============== Functions ===============   == System Changes ==
  1785.  
  1786.         <A>udit trail toggle  <L>ist system files   <G>oodbye (logoff)
  1787.         <C>atalog operations  <O> Macro operations  <F>ile Sub-System
  1788.         <E>dit user record    <P>urge files         <M>essage Sub-System
  1789.         <I>nitialize files    <T>oggle printer      <U>tility Sub-System
  1790.         <J>ump to DOS         <V>ersions            <X>pert toggle
  1791.  
  1792.                        Fig. 6-1: Sysop Sub-System
  1793.                        Fig. 6-1: Sysop Sub-System
  1794.                        Fig. 6-1: Sysop Sub-System
  1795.  
  1796.  
  1797.         6.2. <A>udit trail toggle
  1798.         6.2. <A>udit trail toggle
  1799.  
  1800.         This command allows you to create a standard ASCII text file from
  1801.         any  system  output.  The audit trail file name consists  of  the
  1802.         system  date and a numeric extension - starting with  zero.   For
  1803.         example, the first time the audit trail is enabled on the 15th of
  1804.         December  1986,  the name would be 86-12-15.000.   If  the  audit
  1805.  
  1806.  
  1807.                                                                        21
  1808.                                ROS Sysop Manual
  1809.  
  1810.  
  1811.         trail were turned off and then back on later in the same day, the
  1812.         file name would be 86-12-15.001.
  1813.  
  1814.         6.3. <C>atalog operations
  1815.         6.3. <C>atalog operations
  1816.  
  1817.         This  command  provides access to the file  catalog  and  posting
  1818.         system.   Each operation is described in the following  sections.
  1819.         Refer  to  appendix C for more information on setting  up  a  new
  1820.         catalog.
  1821.  
  1822.         6.3.1. <B>uild
  1823.         6.3.1. <B>uild
  1824.  
  1825.         This command builds two files, "CATALOG" and "CATALOG.BRF"  which
  1826.         are  the contents of the catalog.  The full catalog includes  the
  1827.         descriptions of the files.  The second, brief catalog only  lists
  1828.         the file areas, file names, and file sizes from the catalog.  The
  1829.         sysop  will  be prompted as to which catalog to build  with  each
  1830.         execution of this command.
  1831.  
  1832.         6.3.2. <D>escribe
  1833.         6.3.2. <D>escribe
  1834.  
  1835.         Many  sources are currently available for the  descriptions  that
  1836.         are to be included in your catalog.  These sources include  other
  1837.         bulletin board systems, catalog files you may be currently  main-
  1838.         taining  by hand, and other catalog systems.  ROS  provides  this
  1839.         command to make use of these sources to speed the development  of
  1840.         your catalog.  When this command is executed, ROS will prompt for
  1841.         a  file  name that contains file names and  descriptions  in  the
  1842.         following format:
  1843.  
  1844.              name.ext  description
  1845.  
  1846.         "name.ext" is the file name and extension of a file which may  be
  1847.         in  your  catalog and "description" is the  description  of  that
  1848.         file.
  1849.  
  1850.         After  accepting the file name (a null name will exit this  func-
  1851.         tion),  ROS will prompt for the column in which  the  description
  1852.         starts.  50 characters of description are allowed.  If ROS  finds
  1853.         the  file  name in the current catalog, and  its  description  is
  1854.         currently  blank,  the description from the specified  text  file
  1855.         will be added.  Existing descriptions will not be overwritten nor
  1856.         will  files which are not in the catalog be added.  This  command
  1857.         will  only update descriptions of catalog entries which are  cur-
  1858.               ____
  1859.         rently blank.  In addition, once a description has been used,  it
  1860.         will not be used again.  So, if you have two files with the  same
  1861.         name  in your catalog, only one have a description  added.   But,
  1862.         since this command will not change existing descriptions, it  may
  1863.         be used several times.  Each time, one of these duplicate entries
  1864.         will pick up the description.
  1865.  
  1866.  
  1867.  
  1868.         22
  1869.                                ROS Sysop Manual
  1870.  
  1871.  
  1872.         This  command may even be used to restore a completely  destroyed
  1873.         catalog  if the text file "CATALOG" is still  available.   Simply
  1874.         specify  "CATALOG" for the input text file and column 29 for  the
  1875.         column in which the description starts.  Entries which are  blank
  1876.         in  the  catalog  will  be updated  with  the  descriptions  from
  1877.         "CATALOG."
  1878.  
  1879.         For  example,  call another local BBS or two and  download  their
  1880.         descriptions.   These descriptions do not have to be in any  spe-
  1881.         cial  order, nor does ROS care if there are blank lines or  lines
  1882.         with  special  characters.  What it is looking for  is  an  exact
  1883.         match  of the file name in columns 1-12 of the file.  If this  is
  1884.         found  and  the current catalog description is  blank,  the  text
  1885.         description will be added to the catalog.
  1886.  
  1887.         6.3.3. <E>dit
  1888.         6.3.3. <E>dit
  1889.  
  1890.         This  command  allows the sysop to display and edit  catalog  en-
  1891.         tries.   If the command has not been previously executed  in  the
  1892.         current  session, the first record in the default file area  will
  1893.         be  displayed.  Subsequent entries into this command will  redis-
  1894.         play  record displayed the last time the command was  used.   The
  1895.         following sections describe the commands that may be entered.
  1896.  
  1897.         6.3.3.1. Add
  1898.                  ___
  1899.  
  1900.         This command may be used to add a new record to the catalog.
  1901.  
  1902.         6.3.3.2. Backward
  1903.                  ________
  1904.  
  1905.         This  command changes the displayed record to the last record  in
  1906.         the  previous file area (as defined in the AREA.ROS file).   File
  1907.         areas "wrap" around so that if already displaying a record in the
  1908.         first file area, the last file area will be displayed.
  1909.  
  1910.         6.3.3.3. Change
  1911.                  ______
  1912.  
  1913.         ROS will prompt for and move to a new file area.  The first entry
  1914.         in the specified area will be displayed.
  1915.  
  1916.         6.3.3.4. Delete
  1917.                  ______
  1918.  
  1919.         This command will delete the current catalog entry and its assoc-
  1920.         iated file.  Both actions are verified before taking place.
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.                                                                        23
  1931.                                ROS Sysop Manual
  1932.  
  1933.  
  1934.         6.3.3.5. Edit
  1935.                  ____
  1936.  
  1937.         This command allows the sysop to edit several fields in the cata-
  1938.         log record.  These fields are as follow:
  1939.  
  1940.              Home area      This is the file area in which the file will
  1941.                             spend most of its time.  When a file is added
  1942.                             to the system, by an upload or directly, this
  1943.                             field should be set to reflect the file area
  1944.                             most appropriate to the content of the file.
  1945.                             For example, a new file, MYCB.ARC is uploaded
  1946.                             to the system.  The "current area" (below)
  1947.                             will be set to NEWIN automatically.  Upon
  1948.                             determining the file is another checkbook
  1949.                             balancing program, the sysop may determine
  1950.                             that the file belongs in the ACCOUNTING file
  1951.                             area.  The "home area" should be set to
  1952.                             "ACCOUNTING."  After the file has been in the
  1953.                             NEWIN area for a time, it will be moved to
  1954.                             the ACCOUNTING area when the <P>ost command
  1955.                             is executed.
  1956.              Current area   This is the file area where the file can
  1957.                             presently be found.  IF THIS FIELD IS
  1958.                             CHANGED, THE FILE WILL BE AUTOMATICALLY
  1959.                             RELOCATED TO ITS NEW DOS SUB-DIRECTORY.  This
  1960.                             is done to maintain the accuracy of the
  1961.                             catalog in relation to the system directory.
  1962.              Name           The name of the file
  1963.              Description    The textual description of the file
  1964.              Size           The file size in bytes
  1965.              Accesses       The number of times the file has been
  1966.                             accessed.  If the file is a library (.LBR) or
  1967.                             archive (.ARC), this field will be
  1968.                             incremented each time the file is opened.
  1969.                             For text files, this field will be
  1970.                             incremented each time the file is typed.
  1971.                             Finally, this field will be incremented each
  1972.                             time the file is downloaded using Xmodem
  1973.  
  1974.         Normal editing commands are available.  Please refer to the  User
  1975.         Manual for more information on the editor.
  1976.  
  1977.         6.3.3.6. Forward
  1978.                  _______
  1979.  
  1980.         Similar  to "Backward," ROS will display the first record in  the
  1981.         next file area.  Again, file areas wrap around.
  1982.  
  1983.         6.3.3.7. Hide
  1984.                  ____
  1985.  
  1986.         This  command  will hide the current catalog  entry  from  normal
  1987.         users,  i.e. without sysop access level, the record will  not  be
  1988.  
  1989.  
  1990.         24
  1991.                                ROS Sysop Manual
  1992.  
  1993.  
  1994.         displayed when the file sub-system directory command is executed,
  1995.         nor  will the file be included in the text file "CATALOG."   This
  1996.         attribute is automatically set when ROS adds a file that has  the
  1997.         DOS hidden attribute and when new files are uploaded to the  sys-
  1998.         tem.  When this command is executed, the DOS hidden attribute  is
  1999.         also set for the physical file.
  2000.  
  2001.         6.3.3.8. Next
  2002.                  ____
  2003.  
  2004.         The next alphabetical catalog entry will be displayed.  If  there
  2005.         are no more entries in the current file area, the next file  area
  2006.         will  be entered and displayed, with wrap around as for the  For-
  2007.         ward command.
  2008.  
  2009.         6.3.3.9. Previous
  2010.                  ________
  2011.  
  2012.         The  previous alphabetical catalog entry will be  displayed.   If
  2013.         there are no more entries in the current file area, the  previous
  2014.         file area will be entered and displayed, with wrap around as  for
  2015.         the Backward command.
  2016.  
  2017.         6.3.3.10. Release
  2018.                   _______
  2019.  
  2020.         This  command  is used to release for user view, a  hidden  file.
  2021.         The DOS hidden attribute is also reset.
  2022.  
  2023.         6.3.3.11. Select
  2024.                   ______
  2025.  
  2026.         This command allows the sysop to select a new file name for  dis-
  2027.         play.   In a fashion similar to the "Whereis" command,  ROS  does
  2028.         not  require  a  complete file name and will move  to  the  first
  2029.         matching file name in the current file area.
  2030.  
  2031.         6.3.3.12. Quit
  2032.                   ____
  2033.  
  2034.         This command exits the catalog entry editor.
  2035.  
  2036.         6.3.4. <G>lobal
  2037.         6.3.4. <G>lobal
  2038.  
  2039.         This  command changes the "home" and "current" area  fields  from
  2040.         one value to another.  For example, you have decided that "TOOLS"
  2041.         is  a better file area name than "PROGRAMS."  After  editing  the
  2042.         AREA.ROS file, you start ROS and enter this command to effect the
  2043.         change for all the catalog entries.  No files are moved, only the
  2044.         catalog and its associated index files are updated.  NOTE: If the
  2045.         AREA.ROS  is changed and the catalog entries are not,  the  users
  2046.         will not have access to the files.
  2047.  
  2048.         6.3.5. <L>eaders
  2049.         6.3.5. <L>eaders
  2050.  
  2051.         This command lists the 15 most frequently accessed files.
  2052.  
  2053.  
  2054.                                                                        25
  2055.                                ROS Sysop Manual
  2056.  
  2057.  
  2058.  
  2059.         6.3.6. <P>ost
  2060.         6.3.6. <P>ost
  2061.  
  2062.         This  purpose of this command is to help with the massive  house-
  2063.         keeping necessary on a file repository such as ROS.  For example,
  2064.         new versions of files area added to the system, old versions must
  2065.         be  purged,  changes to the file area structure may  have  to  be
  2066.         made,  etc.  With this command, the process is almost  completely
  2067.         automated, only requiring the sysop to enter the "home" area once
  2068.         for each new file.
  2069.  
  2070.         The name of file and its description are entered by the user  and
  2071.         the other fields are set by the system when the file is uploaded.
  2072.         The "Upload date" and the "Last access" field are used to  deter-
  2073.         mine  when a posting action should take place.  After a file  has
  2074.         been  in  the  NEWIN  area  for  "NewinDays"  days  (defined   in
  2075.         CONFIG.ROS), it will be moved to its Home Area.  After a file has
  2076.         been  in  its  Home  Area  for  "OtherDays"  days  without  being
  2077.         accessed,  it will be moved to the DUSTY area.  This  area  indi-
  2078.         cates  to users that after "DustyDays" days without  access,  the
  2079.         file  will be removed from the system.  From DUSTY, the  file  is
  2080.         actually moved to the ARCHIVE file area which is not available to
  2081.         users.   Files in this area then may be copied to a backup  media
  2082.         such  as floppy disk or tape and then deleted.  The migration  of
  2083.         files through the system can be displayed thus:
  2084.  
  2085.              NEWIN --> home area --> DUSTY --> ARCHIVE --> deleted
  2086.  
  2087.         ROS will not actually delete any files from the system.  This  is
  2088.         left to the sysop.
  2089.  
  2090.         Note the difference in the way ROS determines expiration for  the
  2091.         NEWIN  area compared to all other file areas: in  NEWIN,  "Upload
  2092.         date" is used, while "Last access" is used elsewhere.
  2093.  
  2094.         6.3.7. <R>econcile
  2095.         6.3.7. <R>econcile
  2096.  
  2097.         This  command  is used to ensure the physical directory  and  the
  2098.         catalog  maintained by ROS are in agreement.  If changes  in  the
  2099.         file  size,  date, or status (hidden, released)  are  made,  this
  2100.         command  will detect these changes and update the catalog to  re-
  2101.         flect them.  If files are listed in the catalog, but not found in
  2102.         the  disk directory, ROS will mark them as "Missing."   If  files
  2103.         are found in the disk directory, but not in the catalog, ROS will
  2104.         add them to the catalog.
  2105.  
  2106.         6.3.8. <Q>uit
  2107.         6.3.8. <Q>uit
  2108.  
  2109.         This command terminates the catalog edit session.
  2110.  
  2111.  
  2112.  
  2113.  
  2114.         26
  2115.                                ROS Sysop Manual
  2116.  
  2117.  
  2118.         6.4. <E>dit user record
  2119.         6.4. <E>dit user record
  2120.  
  2121.         When this command is entered the first time, ROS will display the
  2122.         first  available entry in the user file.  Subsequent  entries  of
  2123.         this  command  will display the record of the last  user  edited.
  2124.         The  selected  user  record is displayed while ROS  waits  for  a
  2125.         second  command.  The following sections define  these  secondary
  2126.         commands.
  2127.  
  2128.         6.4.1. <A>dd record
  2129.         6.4.1. <A>dd record
  2130.  
  2131.         This  command may be used to add a new user to the  system.   ROS
  2132.         will  verify  that the name does not already exist.  If  not,  it
  2133.         will prompt for the new password and then display the record  for
  2134.         further  edits.   This command is especially  useful  for  closed
  2135.         systems where new users are not allowed to register on-line.
  2136.  
  2137.         6.4.2. <D>elete record
  2138.         6.4.2. <D>elete record
  2139.  
  2140.         ROS  will prompt to verify that this is the action  desired.   If
  2141.         so, it will delete the user and any messages addressed to or from
  2142.         that user.
  2143.  
  2144.         6.4.3. <E>dit record
  2145.         6.4.3. <E>dit record
  2146.  
  2147.         The cursor will be positioned at the name field for editing using
  2148.         commands identical to those used for messages (refer to the  User
  2149.         Manual).  All fields except the time of last access are editable.
  2150.  
  2151.         ROS  does  not require precise entry of the user name to  find  a
  2152.         record for editing.  It will find the record which is equal to OR
  2153.         GREATER THAN the entered name.  For example, if you cannot remem-
  2154.         ber  how  John Smith spells his last name, enter "John"  for  the
  2155.         first name and "Smith" for the last name.  ROS will find a record
  2156.         even if John spells his last name "Smithe."
  2157.  
  2158.         NOTE:  Similar names can result in the display of a record  other
  2159.         than  the one desired.  The sysop should verify that the  desired
  2160.         user record is the one displayed.
  2161.  
  2162.         6.4.4. <F>orce password
  2163.         6.4.4. <F>orce password
  2164.  
  2165.         ROS,  starting  with version 3.7, encrypts the user  password  in
  2166.         such  a way that it cannot be decrypted - even the  sysop  cannot
  2167.         see  the passwords.   This encryption is done to provide  a  very
  2168.         high  level of security, especially if the user file  comes  into
  2169.         the wrong hands.
  2170.  
  2171.         This  option  allows the sysop to input a new  password  for  the
  2172.         currently  displayed user.  The new password will echo as  it  is
  2173.         typed.
  2174.  
  2175.  
  2176.                                                                        27
  2177.                                ROS Sysop Manual
  2178.  
  2179.  
  2180.  
  2181.         6.4.5. <N>ext record
  2182.         6.4.5. <N>ext record
  2183.  
  2184.         When this command is entered, ROS will find the next  (alphabeti-
  2185.         cally)  user record and display it for edit.  Only  records  with
  2186.         access levels equal or less than the user will be displayed, e.g.
  2187.         alternate  sysops  cannot modify or even view the  primary  sysop
  2188.         record.
  2189.  
  2190.         6.4.6. <P>revious record
  2191.         6.4.6. <P>revious record
  2192.  
  2193.         When this command is entered, ROS will find the previous  (alpha-
  2194.         betically)  user  record and display it for edit.   Access  level
  2195.         restrictions  similar  to  those described for  the  next  record
  2196.         apply.
  2197.  
  2198.         6.4.7. <R>egistered
  2199.         6.4.7. <R>egistered
  2200.  
  2201.         This command will search the user file for the next  (alphabetic-
  2202.         ally)  user that has requested validation.  When the user  record
  2203.         is displayed on the screen, all editing commands are again avail-
  2204.         able.   When ROS returns to the last user edited or selected,  no
  2205.         more records have been found.
  2206.  
  2207.         6.4.8. <S>elect record
  2208.         6.4.8. <S>elect record
  2209.  
  2210.         When this command is entered, ROS will prompt for a new user name
  2211.         and  then display that user for edit.  Access level  restrictions
  2212.         similar to those described for the <N>ext record command apply.
  2213.  
  2214.         6.4.9. <V>alidate user
  2215.         6.4.9. <V>alidate user
  2216.  
  2217.         This command changes the access level and time allowance for  the
  2218.         user  being edited to the values defined in CONFIG.ROS  ("ValAcc"
  2219.         and "ValTime").  It is more convenient than editing the user  and
  2220.         can be performed easily from a remote site.
  2221.  
  2222.         6.4.10. <Q>uit edit session
  2223.         6.4.10. <Q>uit edit session
  2224.  
  2225.         When  all user records have been edited, enter this  command  and
  2226.         ROS will return to the sysop sub-system.
  2227.  
  2228.         6.5. <I>nitialize system files
  2229.         6.5. <I>nitialize system files
  2230.  
  2231.         This  command  is useful for sysops that normally  operate  their
  2232.         system  from a remote site.  With it, ROS can be forced  to  read
  2233.         new  AREA.ROS  and  SYSMTXT.ROS  files,  normally  only  read  at
  2234.         startup.  When this command is executed, ROS will look for  these
  2235.         two  files in the NEWIN file area.  If either is found,  it  will
  2236.         replace  the  original file, ROS will read the new  file(s),  and
  2237.         begin to use the new values.
  2238.  
  2239.  
  2240.         28
  2241.                                ROS Sysop Manual
  2242.  
  2243.  
  2244.  
  2245.         For  example,  a  remote  sysop needs  to  change  a  message  in
  2246.         SYSMTXT.ROS.   The  new  file is uploaded  and  the  <I>nitialize
  2247.         command is used to allow ROS to start using this new file.
  2248.  
  2249.         6.6. <J>ump to DOS
  2250.         6.6. <J>ump to DOS
  2251.  
  2252.         This command allows rapid access to DOS through a shell.  ROS  is
  2253.         still  loaded, but suspended, while DOS is made available to  the
  2254.         sysop.   All normal DOS commands are available either locally  or
  2255.         remotely.  The DOS command "EXIT" is used to return to ROS.
  2256.  
  2257.         6.7. <L>ist system files
  2258.         6.7. <L>ist system files
  2259.  
  2260.         When  this  command is entered, four secondary  commands  may  be
  2261.         entered  to  select which file should be listed.   The  following
  2262.         sections define these secondary commands.
  2263.  
  2264.         6.7.1. <A>ll system files
  2265.         6.7.1. <A>ll system files
  2266.  
  2267.         This command will list both the log and the message files.
  2268.  
  2269.         6.7.2. <L>og file
  2270.         6.7.2. <L>og file
  2271.  
  2272.         ROS  maintains a time and date tagged list of most system  opera-
  2273.         tions.   This command will display this list.  From the  informa-
  2274.         tion contained in this file, the sysop can determine what kind of
  2275.         activity  the  system is being used for, what users  seem  to  be
  2276.         having problems, what users are abusing their privileges, etc.
  2277.  
  2278.         6.7.3. <M>essages
  2279.         6.7.3. <M>essages
  2280.  
  2281.         All messages after the specified date will be displayed in chron-
  2282.         ological order.
  2283.  
  2284.         6.7.4. <Q>uit
  2285.         6.7.4. <Q>uit
  2286.  
  2287.         This command will return control to the sysop sub-system.
  2288.  
  2289.         6.8. <O> Macro operations
  2290.         6.8. <O> Macro operations
  2291.  
  2292.         In  addition  to being able to read characters  from  either  the
  2293.         keyboard or the remote channel, ROS can read from internal  char-
  2294.         acter  strings  called "macros."  These strings can  be  used  to
  2295.         execute  any  sequence  of operations as defined  by  the  sysop.
  2296.         Since some of the system maintenance commands can take some  time
  2297.         to complete, macros can be very convenient.
  2298.  
  2299.         In addition to the text editing commands described in the  User's
  2300.         Guide, pressing "B" for <B>egin will cause ROS to prompt for  the
  2301.         macro number to execute.  Since the macro file is a standard text
  2302.  
  2303.  
  2304.                                                                        29
  2305.                                ROS Sysop Manual
  2306.  
  2307.  
  2308.         file,  most text editors and word processors can also be used  to
  2309.         edit the MACRO.ROS file.  High bits in the file, as set by  Word-
  2310.         Star  in document mode, will confuse ROS.  WordStar  non-document
  2311.         mode is fine.
  2312.  
  2313.         ROS is still monitoring both the local and remote keyboards while
  2314.         processing  a macro so the sysop can pause (^S) or cancel (^C)  a
  2315.         command, but macro processing will continue until complete.
  2316.  
  2317.         Since  a carriage return is used to terminate the entry of a  new
  2318.         macro  string, a slash (/) may be entered into the  macro.   When
  2319.         encountered,  ROS  will convert this character  into  a  carriage
  2320.         return.   As  shown  in the example, control  characters  may  be
  2321.         entered  by prefixing a standard letter with a carat ("^").   For
  2322.         example, CTRL-C may be inserted into a macro with the two charac-
  2323.         ter string "^C".
  2324.  
  2325.         6.8.1. Time Initiated Macro
  2326.         6.8.1. Time Initiated Macro
  2327.  
  2328.         If  the  macro  starts  with a colon and  a  time  of  day,  e.g.
  2329.         ":00:15", ROS will use this time to automatically start the macro
  2330.         execution.  Only one time initiated macro is allowed.
  2331.  
  2332.         6.8.2. Macro Examples
  2333.         6.8.2. Macro Examples
  2334.  
  2335.         The sample macro file included with ROS performs the following:
  2336.  
  2337.              Macro #1 - :03:00 Sysop^Mpassword^Mxcrpbybnqob3^M
  2338.  
  2339.              :03:00       time to start the macro
  2340.              Sysop^M      user name terminated with a carriage return
  2341.              password^M   password terminated with a carriage return
  2342.              x            enter the sysop sub-system
  2343.              c            start the catalog processor
  2344.              r            reconcile the catalog
  2345.              p            post the files
  2346.              b            build a new text catalog
  2347.              y            include descriptions (CATALOG)
  2348.              b            build another new text catalog
  2349.              n            don't include descriptions (CATALOG.BRF)
  2350.              q            quit the catalog processor
  2351.              o            macro operations
  2352.              b            begin macro number...
  2353.              3^M          ...three
  2354.  
  2355.              Macro #2 - payn
  2356.  
  2357.              p            purge
  2358.              a            all files
  2359.              y            yes, really do it
  2360.              n            no, don't renumber messages
  2361.  
  2362.  
  2363.         30
  2364.                                ROS Sysop Manual
  2365.  
  2366.  
  2367.  
  2368.              Macro #3 - jARCHIVE^M
  2369.  
  2370.              j            jump to DOS
  2371.              ARCHIVE^M    use ARCHIVE.BAT for commands while in DOS
  2372.              g            goodbye
  2373.              y            yes, really log out
  2374.  
  2375.         The  macro  linkage shown at the end of macro number one  is  not
  2376.         necessary, but serves to show how linking macros is accomplished.
  2377.  
  2378.         6.9. <P>urge files
  2379.         6.9. <P>urge files
  2380.  
  2381.         This  command  purges and compresses selected  files  of  deleted
  2382.         entries.  It processes four different files, each selectable by a
  2383.         single  command,  or all four files together.  All  commands  are
  2384.         verified before continuing.
  2385.  
  2386.         Sufficient  disk space must be available for these operations  or
  2387.         ROS will report an error and terminate.  Should this happen,  ROS
  2388.         will automatically recover from the old files the next time it is
  2389.         started, but extraneous files may be left on the disk.
  2390.  
  2391.         6.9.1. Purge All
  2392.         6.9.1. Purge All
  2393.  
  2394.         This  command  purges  all  four  files,  i.e.  it  automatically
  2395.         performs a purge of the log, catalog, user, and message files.
  2396.  
  2397.         6.9.2. Purge Catalog
  2398.         6.9.2. Purge Catalog
  2399.  
  2400.         This  command purges the file catalog system of any entries  that
  2401.         are currently marked as "Missing."
  2402.  
  2403.         6.9.3. Purge Log
  2404.         6.9.3. Purge Log
  2405.  
  2406.         This command removes all entries from the log file.
  2407.  
  2408.         6.9.4. Purge Messages
  2409.         6.9.4. Purge Messages
  2410.  
  2411.         As  described in the introduction, deleting a message only  marks
  2412.         that  message for delete.  To physically remove the message  from
  2413.         the disk, the message files must be purged.
  2414.  
  2415.         6.9.5. Purge Users
  2416.         6.9.5. Purge Users
  2417.  
  2418.         This command deletes all users that have not logged in within the
  2419.         times specified, in CONFIG.ROS, by either "UnvDays" (for  unvali-
  2420.         dated users) or "ValDays" (for validated users).  When a user  is
  2421.         purged with this command, ROS will also mark any messages sent to
  2422.         or from that user for deletion.
  2423.  
  2424.  
  2425.  
  2426.                                                                        31
  2427.                                ROS Sysop Manual
  2428.  
  2429.  
  2430.         6.10. <T>oggle printer
  2431.         6.10. <T>oggle printer
  2432.  
  2433.         The  currently  assigned LST device is  alternately  enabled  and
  2434.         disabled.   To  prevent inadvertent toggling when no  printer  is
  2435.         connected, this command is verified before continuing.  In  addi-
  2436.         tion,  ROS  traps the DOS critical error handler and  will  issue
  2437.         warning  03-09 if the printer is not available.  Processing  will
  2438.         then continue.
  2439.  
  2440.         6.11. <V>ersions
  2441.         6.11. <V>ersions
  2442.  
  2443.         This  command displays the version numbers of DOS,  DESQview  (if
  2444.         installed), and ROS.
  2445.  
  2446.         6.12. Other commands available to the sysop
  2447.         6.12. Other commands available to the sysop
  2448.  
  2449.         Naturally,  all the user commands are available to the sysop  in-
  2450.         cluding  the ability to return to one of the other three  command
  2451.         sub-systems.  These commands are discussed below, as well as some
  2452.         enhancements to the commands that normal users have.
  2453.  
  2454.         6.12.1. <G>oodbye (logoff)
  2455.         6.12.1. <G>oodbye (logoff)
  2456.  
  2457.         This command terminates the session.
  2458.  
  2459.         6.12.2. <F>ile Transfer System
  2460.         6.12.2. <F>ile Transfer System
  2461.  
  2462.         This  command causes ROS to exit the sysop sub-system  and  enter
  2463.         the file transfer sub-system.
  2464.  
  2465.         6.12.3. <M>essage System
  2466.         6.12.3. <M>essage System
  2467.  
  2468.         This  command causes ROS to exit the sysop sub-system  and  enter
  2469.         the message sub-system.
  2470.  
  2471.         6.12.4. <U>tility System
  2472.         6.12.4. <U>tility System
  2473.  
  2474.         This  command causes ROS to exit the sysop sub-system  and  enter
  2475.         the utility sub-system.
  2476.  
  2477.         6.12.5. <X>pert mode toggle
  2478.         6.12.5. <X>pert mode toggle
  2479.  
  2480.         In the sysop sub-system, pressing "X" will alternate between help
  2481.         levels  1 and 3.  In other sub-systems, pressing "X"  will  cause
  2482.         ROS to check the access level of the user.  Sysops will enter the
  2483.         sysop sub-system and normal users will toggle their help level.
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.         32
  2492.                                ROS Sysop Manual
  2493.  
  2494.  
  2495.         6.12.6. Command Enhancements
  2496.         6.12.6. Command Enhancements
  2497.  
  2498.         6.12.6.1. Changing a Message Status or Message Area
  2499.                   _________________________________________
  2500.  
  2501.         After  reading a message, the sysop will be given the  option  of
  2502.         altering the message area or status of the message.  The  options
  2503.         are as follow:
  2504.  
  2505.              <D>elete            mark message as deleted
  2506.              <I>ndividual        mark message as private
  2507.              <M>ove              move message to another message area
  2508.                                  (ROS will prompt for the new area name
  2509.                                  as defined in AREA.ROS)
  2510.              <P>ublic            mark message as public
  2511.              <R>ead              mark message as having been read
  2512.  
  2513.         Note  that  all of these commands are available for  any  message
  2514.         that  can  be displayed, even one which is  currently  marked  as
  2515.         "deleted."  This allows the sysop to "un-delete" a message.
  2516.  
  2517.         6.12.6.2. Setting the System Time and Date
  2518.                   ________________________________
  2519.  
  2520.         After displaying the time and date with the <T>ime command in the
  2521.         utility sub-system, ROS will allow the sysop to set these values.
  2522.  
  2523.         6.12.6.3. User List Additions
  2524.                   ___________________
  2525.  
  2526.         When  the  user list is requested, ROS will allow  the  sysop  to
  2527.         enter one of four parameters:
  2528.  
  2529.              <A>ll                    List all fields in the user
  2530.                                       records.  This listing may be
  2531.                                       captured by enabling the audit
  2532.                                       trail with the <A>udit command in
  2533.                                       the sysop sub-system.  Table 6-1
  2534.                                       lists the fields and their widths.
  2535.                                       This fixed field length format is
  2536.                                       ideal for input into a database
  2537.                                       management system such as dBase.
  2538.              <E>xceptional            List users with an unusual access
  2539.                                       level or time limit.
  2540.              <U>nvalidated            List unvalidated, unregistered
  2541.                                       users.
  2542.              <Q>uick                  List user names only (this is the
  2543.                                       same listing normal users get).
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.                                                                        33
  2553.                                ROS Sysop Manual
  2554.  
  2555.  
  2556.              Field name                 Field width
  2557.              ______________________________________
  2558.  
  2559.              First name                 15
  2560.              Last name                  15
  2561.              Address                    30
  2562.              City                       20
  2563.              State                       2
  2564.              Zip code                    9
  2565.              Phone                      13
  2566.              System                     10
  2567.              Access level                3
  2568.              Time limit                  3
  2569.              Default message area       12
  2570.              Default file area          12
  2571.              Default transfer protocol   1
  2572.              Nulls                       2
  2573.              Caps lock                   1 ("T"rue or "F"alse)
  2574.              Prompt bell                 1 ("T"rue of "F"alse)
  2575.              Help level                  1
  2576.              Columns                     2
  2577.              Lines                       2
  2578.              Times on                    5
  2579.              Date last on               18
  2580.              Normal time                 5
  2581.              Total time                  5
  2582.              Last high message          10
  2583.              Uploads                     5
  2584.              Downloads                   5
  2585.  
  2586.                   Table 6-1: Format of User File Listing
  2587.                   Table 6-1: Format of User File Listing
  2588.                   Table 6-1: Format of User File Listing
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.         34
  2613.                                ROS Sysop Manual
  2614.  
  2615.  
  2616.         7. SECURITY
  2617.         7. SECURITY
  2618.         7. SECURITY
  2619.  
  2620.         The security of a computer system is of paramount importance when
  2621.         that  system is readily available through the  telephone  system.
  2622.         To make ROS robust enough to withstand both incorrect entries and
  2623.         malicious  attacks,  a simple but effective method  is  used:  an
  2624.         access  level, ranging from 0 to 255, is assigned to  each  user.
  2625.         System  privileges are based upon this number.  In  general,  the
  2626.         higher the number, the greater the privileges the user has.
  2627.  
  2628.         The following access levels are recommended (set in CONFIG.ROS):
  2629.  
  2630.              0-9       Twit - will be logged off immediately
  2631.              10-19     Unvalidated user - limited message and files
  2632.                        access
  2633.              11        Registered user - has not yet been validated
  2634.              20-249    Normal user - full message and files access
  2635.              250-254   Alternate sysops
  2636.              255       Primary sysop
  2637.  
  2638.         This  access  level structure allows sysops to  review  all  user
  2639.         records in the system, including their own, but no one may change
  2640.         or even display the record of a user with a higher access level.
  2641.  
  2642.              CAUTION:  The primary sysop can edit any  user  record,
  2643.              including his own.  Care must be taken to not  acciden-
  2644.              tally lower the sysop access level.
  2645.  
  2646.         With  version 3.7, ROS encrypts the user password to further  en-
  2647.         sure  security.  This encryption uses a "one-way" algorithm  that
  2648.         has  no  simple inverse, i.e. the encrypted  password  cannot  be
  2649.         readily  converted  into the un-encrypted password.   While  this
  2650.         should  help protect against programs that attack the user  file,
  2651.         the best security is to beware of "Trojan Horse" programs and  to
  2652.         be very cautious with programs that you run on your system.
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.                                                                        35
  2672.                                ROS Sysop Manual
  2673.  
  2674.  
  2675.         8. COMMAND LINE OPTIONS
  2676.         8. COMMAND LINE OPTIONS
  2677.         8. COMMAND LINE OPTIONS
  2678.  
  2679.         Four command line options are recognized by ROS:
  2680.  
  2681.              /r        reorganize user and catalog files
  2682.              /d        direct connect - ignore modem responses
  2683.              /m        modem information display
  2684.              /o=       overlay file path
  2685.  
  2686.         These  options may be used in any order, with or  without  spaces
  2687.         separating them.
  2688.  
  2689.         8.1. Option /r
  2690.         8.1. Option /r
  2691.  
  2692.         ROS can recover from many types of damage to the user and catalog
  2693.         files,  and it can recover from corrupted or even  missing  index
  2694.         files  (in  fact, if you suspect that your index files  may  have
  2695.         become  corrupted, simply delete them.  ROS will rebuild them  as
  2696.         necessary.  This includes USERIDX.ROS, CATNNDX.ROS,  CATDNDX.ROS,
  2697.         and SYSMIDX.ROS).  To reorganize the user and catalog data  files
  2698.         and  subsequently rebuild the index files, you may add a "/r"  to
  2699.         the command line.
  2700.  
  2701.         Normally, this option is not needed, but there may be times  when
  2702.         it  can improve or even restore system operation.   For  example,
  2703.         while  ROS  re-uses  deleted records and  keeps  USERDAT.ROS  and
  2704.         CATDAT.ROS  as  compact  as possible, you may wish  to  use  this
  2705.         option to remove the deleted records from the file.
  2706.  
  2707.         Another  situation  when this option is useful is  after  a  long
  2708.         period  of  activity during which many users or  catalog  entries
  2709.         have been added to the system and many others have been  deleted.
  2710.         ROS will always access these files in alphabetical order, but  it
  2711.         may do so with quite a bit of disk activity due to the nature  of
  2712.         the  file.   With  this  option, ROS will  sort  these  files  to
  2713.         minimize the disk thrashing needed for sequential access.
  2714.  
  2715.         The  third situation in which you may need to recover  your  data
  2716.         and  index files should never occur, but a disk failure or  other
  2717.         serious  system problem could cause damage to the data  or  index
  2718.         files.   If you suspect that any of these files may  be  damaged,
  2719.         use  this  option.   Note that starting  with  version  3.7,  ROS
  2720.         commits  to  disk all system files frequently  to  minimize  data
  2721.         loss.  You can even reset or power down the computer while ROS is
  2722.         running   without  serious  consequences,  though  this  is   not
  2723.         recommended.
  2724.  
  2725.         During  execution, ROS will display counts of  records  processed
  2726.         and the supported data files on which it is working.
  2727.  
  2728.  
  2729.  
  2730.  
  2731.         36
  2732.                                ROS Sysop Manual
  2733.  
  2734.  
  2735.         8.2. Option /d
  2736.         8.2. Option /d
  2737.  
  2738.         This option causes ROS to ignore the modem.  It is useful in  two
  2739.         situations.  First, there may be situations when you do not  have
  2740.         a modem connected to the serial port or the modem is already off-
  2741.         hook  and you do not want to hang up.  Since modem  commands  and
  2742.         modem  responses are inhibited with this command, it may also  be
  2743.         used  when  there  is no modem connected at all.   In  fact,  the
  2744.         system may be connected to another computer.  Pressing "F2"  will
  2745.         initiate a session with that local computer.
  2746.  
  2747.         8.3. Option /m
  2748.         8.3. Option /m
  2749.  
  2750.         To  assist in setting up your modem, the command  line  parameter
  2751.         "/m"  may be used to open a one line window at the bottom of  the
  2752.         screen.   In this window, ROS will display all  ASCII  characters
  2753.         that  are sent to and received from the modem.  The left half  of
  2754.         this  line displays the characters sent to the modem,  the  right
  2755.         half  displays  what the modem has sent back.   A  left  pointing
  2756.         triangle is used to indicate a carriage return, and a down  poin-
  2757.         ting arrow indicates a line feed.
  2758.  
  2759.         8.4. Option /o=
  2760.         8.4. Option /o=
  2761.  
  2762.         ROS  will  normally  look in the  default  sub-directory  of  the
  2763.         default drive for its overlays.  There are occasions however when
  2764.         it  is  useful  to start ROS from  another  area.   For  example,
  2765.         running  two systems on one computer under DESQview.   The  first
  2766.         system  is  started in the default drive/directory.   The  second
  2767.         system  is run on another drive or another sub-directory, but  it
  2768.         uses  the  same  program and overlay files  as  the  first.   For
  2769.         example, the command would be:
  2770.  
  2771.         c:\abq-ros\ros /o=c:\abq-ros
  2772.  
  2773.         The  first part ("c:\abq-ros\ros") tells DOS where to go to  find
  2774.         the  ROS.COM file.  The second part ("/o=c:\abq-ros")  tells  ROS
  2775.         where to find its overlay files.
  2776.  
  2777.         This  option is also valuable if you have a RAMdisk.  By  putting
  2778.         the  overlay files in RAMdisk, ROS can get the overlays it  needs
  2779.         very  quickly,  speeding up the system and reducing  drive  wear.
  2780.         Putting  ROS.COM in the RAMdisk is of little value since once  it
  2781.         is loaded into memory further accesses are not required.
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.                                                                        37
  2792.                                ROS Sysop Manual
  2793.  
  2794.  
  2795.         9. OTHER VERSIONS OF ROS
  2796.         9. OTHER VERSIONS OF ROS
  2797.         9. OTHER VERSIONS OF ROS
  2798.  
  2799.         ROS file update utility - ROS36-37.COM
  2800.  
  2801.         ROS36-37.COM  converts  version 3.6 data files  into  the  format
  2802.         expected by version 3.7.  The original files will still exist but
  2803.         with a file extension of "BAK" (backup).  Once you are  satisfied
  2804.         that  the  new files operate correctly, the backup files  may  be
  2805.         deleted.
  2806.  
  2807.         NOTE:  ROS36-37.COM will only operate correctly on standard  ver-
  2808.         sion  3.6 format files.  Attempts to run the program using  files
  2809.         from  other  versions of ROS, including version 3.7  or  modified
  2810.         versions of ROS may result in output files full of junk.
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.         38
  2851.                                ROS Sysop Manual
  2852.  
  2853.  
  2854.         A. CONNECTING THE MODEM
  2855.         A. CONNECTING THE MODEM
  2856.         A. CONNECTING THE MODEM
  2857.  
  2858.         The single most common problem sysops have had with setting up  a
  2859.         new ROS installation has been with the modem: "my computer  works
  2860.         fine with Procomm, but hangs when I run ROS."  Since the rest  of
  2861.         the  system hardware (disks, memory, etc.) is compatible  at  the
  2862.         DOS  level, ROS can count on what will be available.  But,  since
  2863.         DOS  does not support interrupt driven communication port  input-
  2864.         output,  ROS has to bypass DOS, and even the BIOS, to get to  the
  2865.         modem.
  2866.  
  2867.         In  addition, "compatible" modems almost never are.  Even  models
  2868.         made  by  the same manufacturer may respond differently  to  com-
  2869.         mands.  Sometimes these differences are marked, such as "NO  DIAL
  2870.         TONE"  instead of "DIAL TONE."  More often, the  differences  are
  2871.         subtle,  such as whether or not the modem returns a CR/LF  before
  2872.         and after verbal responses.  One modem does on some responses and
  2873.         not on others.  Another modem even changes baud rate WHILE IT  IS
  2874.         SENDING the connect response to the computer!  ROS is designed to
  2875.         be robust in the way it handles the modem and "hooks" are  provi-
  2876.         ded  to  be able to get to almost everything the  modem  and  ROS
  2877.         need.
  2878.  
  2879.         Nonetheless,  experimentation may be required to get a new  modem
  2880.         operational.   Start with the simplest command string that  works
  2881.         and  add to it if necessary.  Usually, the initialization  string
  2882.         will require the most work.
  2883.  
  2884.         Most  terminal emulation programs such as Procomm or  Qmodem  use
  2885.         open-loop control, i.e. they assume that the modem understood the
  2886.         command it was sent, although they do monitor the modem for  some
  2887.         command responses, such as "BUSY" or "CONNECT."
  2888.  
  2889.         ROS on the other hand, is expected to operate for long periods of
  2890.         time without attention, and thus drives the modem in  closed-loop
  2891.         mode,  i.e. all characters sent to the modem are expected  to  be
  2892.         echoed  by the modem back to the computer.  Then, ROS  waits  for
  2893.         the  modem  to respond to the command with a  result  code.   For
  2894.         example,  when ROS commands the modem to go off-hook  (answer  an
  2895.         incoming call), the modem should eventually tell ROS at what baud
  2896.         rate the connection was made or that the connection failed.
  2897.  
  2898.         When attaching a modem to ROS, then, be sure that the modem swit-
  2899.         ches are set to allow "modem echo" and "result code display."  In
  2900.         addition,  set  the modem to use "verbal (word)  messages"  since
  2901.         this matches the CONFIG.ROS file that is included with ROS.   You
  2902.         may,  of course, modify the configuration file and then  set  the
  2903.         modem to return "numeric result codes."
  2904.  
  2905.         The only exception to the need for a character by character  echo
  2906.         is  during  the modem reset string ("CmndReset"  in  CONFIG.ROS).
  2907.  
  2908.  
  2909.                                                                        39
  2910.                                ROS Sysop Manual
  2911.  
  2912.  
  2913.         Some modems do not have a switch for "modem echo" and must be set
  2914.         into this mode through a command.  "CmndReset" should be used for
  2915.         this.  If the modem requires a time delay after it is reset until
  2916.         it  will  accept another command, use tilde characters  ("~")  as
  2917.         required.   Brace characters ("{") may also be included  in  this
  2918.         string to complete each command and start another.  For  example,
  2919.         to  reset a modem, wait for two seconds, and set the  echo  mode,
  2920.         the following "CmndReset" string could be used:
  2921.  
  2922.         ATZ{~~~~ATE1{
  2923.  
  2924.         Two  other common switch settings should be considered.  The  RS-
  2925.         232C  Data Carrier Detect (DCD) is used by ROS to determine  whe-
  2926.         ther  or  not a connection is still valid.  In other  words,  ROS
  2927.         monitors  DCD and will terminate a session if it determines  that
  2928.         DCD has been lost.  Most modems have a switch setting that allows
  2929.         the  modem to control DCD, based on the condition of the  connec-
  2930.         tion,  or  to force DCD always on.  The modem should  be  set  to
  2931.         control DCD.
  2932.  
  2933.         Another  switch determines in what way the modem will respond  to
  2934.         Data Terminal Ready (DTR).  This signal, coming from the computer
  2935.         and  controlled  by  ROS, may be used to enable  or  disable  the
  2936.         modem.   For  example, when a user completes a  session  and  ROS
  2937.         tries to hang-up the modem, it first drops DTR.  If the modem  is
  2938.         set  to disconnect when DTR is dropped, ROS will immediately  see
  2939.         the  loss of DCD and will recycle between callers  very  quickly.
  2940.         If  after a few seconds, DCD is still present, ROS will send  the
  2941.         local  mode escape sequence ("CmndLocal" in CONFIG.ROS) and  then
  2942.         the  hang-up sequence ("CmndHangup" in CONFIG.ROS) to  disconnect
  2943.         the  caller.  These steps take a little longer than simply  drop-
  2944.         ping DTR.
  2945.  
  2946.         Some  modems control DTR response through commands.   These  com-
  2947.         mands may be included in the reset or initialization strings sent
  2948.         to the modem ("CmndReset" or "CmndInit") instead of, or in  addi-
  2949.         tion to, the switch settings.
  2950.  
  2951.         Finally, some modems can be set to automatically answer the phone
  2952.         when a ring is detected.  This function should be disabled  since
  2953.         ROS will tell the modem when to answer the phone.
  2954.  
  2955.         When  you are satisfied that ROS and the modem are  communicating
  2956.         properly,  just start ROS without the "/M" to improve  the  local
  2957.         display appearance.
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.         40
  2967.                                ROS Sysop Manual
  2968.  
  2969.  
  2970.         B. BUILDING A NEW FILE CATALOG
  2971.         B. BUILDING A NEW FILE CATALOG
  2972.         B. BUILDING A NEW FILE CATALOG
  2973.  
  2974.         Using commands built into ROS and existing description files  can
  2975.         greatly  simplify  the process of building a  new  file  catalog.
  2976.         After  starting the session, enter the sysop  sub-system.   Enter
  2977.         "C"  to start the catalog processor and then enter "R" to  recon-
  2978.         cile the catalog with the disk directories.  Since the catalog is
  2979.         currently empty, ROS will add the files it finds to the  catalog.
  2980.         After  ROS completes this process, enter a "D" to  describe  what
  2981.         has  been  added.  This command will read an existing  text  file
  2982.         that may describe many of the files you have.  After this process
  2983.         is  complete,  you may enter a "B" to build the  textual  catalog
  2984.         ("CATALOG") for users to download.
  2985.  
  2986.         If  there are many gaps in "CATALOG," you might consider  editing
  2987.         this  file using a word processor and using this edited  file  as
  2988.         input to the describe command.  Existing descriptions will not be
  2989.         altered,  but  newly  added descriptions will  be  put  into  the
  2990.         catalog system.
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.                                                                        41
  3026.                                ROS Sysop Manual
  3027.  
  3028.  
  3029.         C. WARNING AND ERROR MESSAGES
  3030.         C. WARNING AND ERROR MESSAGES
  3031.         C. WARNING AND ERROR MESSAGES
  3032.  
  3033.         When ROS encounters an error or a situation it cannot handle,  it
  3034.         will issue a message in one of the following forms:
  3035.  
  3036.              "Warning xx-yy" or
  3037.              "Error xx-yy"
  3038.  
  3039.         The  warning  message  is recoverable and ROS  will  continue  to
  3040.         operate  if  possible.  Errors are fatal and will result  in  the
  3041.         termination of processing.
  3042.  
  3043.         The most common warning message will probably be "Warning  01-F1"
  3044.         indicating that ROS could not find the sub-directory indicated in
  3045.         the  AREA.ROS file.  Editing that file will usually  correct  the
  3046.         problem.   Only two class 2 errors should ever be seen, "F0"  and
  3047.         "FF."  The first, "F0" may occur if you have specified an  incor-
  3048.         rect path in the command line using the "/o=" option; if you have
  3049.         started ROS in a sub-directory that does not contain the  overlay
  3050.         files;  or if ROS does not have enough file handles.   Make  sure
  3051.         line  "FILES=20"  (or more) is included in your  CONFIG.SYS  file
  3052.         (see  section 4.1 for more information). The second  error  could
  3053.         occur  if you have insufficient memory or if you are running  ROS
  3054.         in  a window that is not large enough.  Running  under  DesqView,
  3055.         ROS  requires  a 160k window.  The most common type  three  error
  3056.         will  be a warning that the printer is not on-line, "Warning  03-
  3057.         09."  The most common type four error will probably be "Error 04-
  3058.         18" which indicates that ROS cannot access LCOMX.  LCOMX must  be
  3059.                                                                  ____
  3060.         run before ROS.
  3061.  
  3062.         Other messages may be seen which indicate problems that should be
  3063.         corrected before continuing.
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.         42
  3086.                                ROS Sysop Manual
  3087.  
  3088.  
  3089.  
  3090.              Class 0 - Miscellaneous:
  3091.  
  3092.              01   ^C entered
  3093.              02   Undefined error
  3094.              03   Undefined I/O error
  3095.              04   Could not open primary data or index file
  3096.  
  3097.              Class 1 - I/O:
  3098.  
  3099.              01   File does not exist
  3100.              02   File not open for input
  3101.              03   File not open for output
  3102.              04   File not open
  3103.              10   Error in numeric format
  3104.              20   Operation not allowed on a logical device
  3105.              21   Not allowed in direct mode
  3106.              22   Assign to standard files not allowed
  3107.              90   Record length mismatch
  3108.              91   Seek beyond end-of-file
  3109.              99   Unexpected end-of-file
  3110.              F0   Disk write error
  3111.              F1   Directory full or missing
  3112.              F2   File size overflow
  3113.              F3   Too many open files
  3114.              FF   File disappeared
  3115.  
  3116.              Class 2 - Run-time:
  3117.  
  3118.              01   Floating point overflow
  3119.              02   Floating point divide by zero
  3120.              03   Negative square root argument
  3121.              04   Integer divide by zero or negative ln argument
  3122.              10   String length exceeds 255
  3123.              11   String index out of range
  3124.              90   Array index out of range
  3125.              91   Scalar or subrange assignment out of range
  3126.              92   Integer assignment out of range
  3127.              F0   Overlay file not found
  3128.              FF   Heap/stack collision
  3129.  
  3130.              Class 3 - DOS critical errors:
  3131.  
  3132.              00   Attempt to write on write-protected disk
  3133.              01   Unknown unit
  3134.              02   Drive not ready
  3135.              03   Unknown command
  3136.              04   Data error (CRC)
  3137.              05   Bad request structure length
  3138.              06   Seek error
  3139.              07   Unknown media type
  3140.  
  3141.  
  3142.                                                                        43
  3143.                                ROS Sysop Manual
  3144.  
  3145.  
  3146.              08   Sector not found
  3147.              09   Printer out of paper
  3148.              0A   Write fault
  3149.              0B   Read fault
  3150.              0C   General failure
  3151.  
  3152.              Class 4 - Async I/O:
  3153.  
  3154.              00   Operation Successful
  3155.              02   Invalid COM port number - must be 1 or 2
  3156.              03   COM port is not open
  3157.              04   Invalid parameters level 0
  3158.              06   No serial port found
  3159.              07   Output Queue Full
  3160.              09   COM port already open
  3161.              0A   Input Queue is empty
  3162.              14   Improper parameter specified
  3163.              15   Input Queue Size too small
  3164.              16   Output Queue Size too small
  3165.              17   Interrupt level out of range
  3166.              18   LCOMX has not been loaded
  3167.              1F   Invalid baud rate
  3168.              20   Invalid parity specification
  3169.              21   Invalid number of data bits requested
  3170.              22   Invalid number of stop bits requested
  3171.              23   Both Bit Trimming and Forcing attempted
  3172.              24   Bit Forcing/Trimming requires 8 data bits
  3173.              25   Invalid Break time
  3174.              64   Internal Level Two Error
  3175.              FF   Internal Level Zero Error
  3176.  
  3177.              Class 5 - Catalog maintenance:
  3178.  
  3179.              00   Move successful
  3180.              01   Source area not found
  3181.              02   Destination area not found
  3182.              03   Source file not found
  3183.              04   Destination file already exists
  3184.              05   Could not create destination file
  3185.              06   Could not delete source file
  3186.              07   Could not update catalog
  3187.  
  3188.                         Table C-1: Error Messages
  3189.                         Table C-1: Error Messages
  3190.                         Table C-1: Error Messages
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.         44
  3202.                                ROS Sysop Manual
  3203.  
  3204.  
  3205.         D. ROS USAGE AND PROBLEM REPORT
  3206.         D. ROS USAGE AND PROBLEM REPORT
  3207.         D. ROS USAGE AND PROBLEM REPORT
  3208.  
  3209.         Your comments and suggestions are important as they help  improve
  3210.         and develop ROS.  Please feel free to file this report more  than
  3211.         once.  Thanks in advance for taking the time to complete and send
  3212.         this questionnaire.
  3213.  
  3214.  
  3215.         Your name:                                     Date:   /   /
  3216.  
  3217.         Company:
  3218.  
  3219.         Address:
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.         Please give a brief description of how you use ROS:
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.         When did you first receive ROS?
  3232.  
  3233.         Version number?
  3234.  
  3235.         What type of computer is it used on?
  3236.  
  3237.         What is your average usage per day?
  3238.  
  3239.         Do you have any experience with similar products, even on other
  3240.         computers?
  3241.  
  3242.         If so, please describe:
  3243.  
  3244.  
  3245.  
  3246.         How long have you been using computers?
  3247.  
  3248.         Using a scale of 1-10 (1=very bad, 10=very good), please indicate
  3249.         your feelings about the following:
  3250.  
  3251.              The system performance:
  3252.  
  3253.              The system operations manual:
  3254.  
  3255.              The user manual:
  3256.  
  3257.              The ease of use:
  3258.  
  3259.  
  3260.                                                                        45
  3261.                                ROS Sysop Manual
  3262.  
  3263.  
  3264.  
  3265.              The practicality or usefulness of this product:
  3266.  
  3267.              Your overall satisfaction:
  3268.  
  3269.              The overall satisfaction of your users:
  3270.  
  3271.  
  3272.         What would you say are the BEST features of ROS?
  3273.  
  3274.  
  3275.  
  3276.  
  3277.         What would you say are the WORST features of ROS?
  3278.  
  3279.  
  3280.  
  3281.  
  3282.         List any extraneous or useless features:
  3283.  
  3284.  
  3285.  
  3286.  
  3287.         List any enhancements you would like to see added:
  3288.  
  3289.  
  3290.  
  3291.  
  3292.         Describe any problems you have encountered, including examples if
  3293.         possible:
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.         46
  3318.                                ROS Sysop Manual
  3319.  
  3320.  
  3321.         E. INVOICE
  3322.         E. INVOICE
  3323.         E. INVOICE
  3324.  
  3325.  
  3326.  
  3327.         Steven Fox                              Date:    /    /
  3328.         2112 White Cloud NE
  3329.         Albuquerque, NM 87112
  3330.  
  3331.  
  3332.  
  3333.         Name, address, phone:
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.         Product                   Quantity   Price Each     Total
  3341.  
  3342.  
  3343.  
  3344.         ROS License Fee           ________    @ $35.00    _______
  3345.  
  3346.  
  3347.         Total:                                            _______
  3348.  
  3349.  
  3350.         Please make checks payable to Steven Fox.
  3351.  
  3352.         Retain a copy of this invoice for your records.
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.                                                                        47
  3377.                                      Index
  3378.  
  3379.  
  3380.          INDEX
  3381.          INDEX
  3382.          INDEX
  3383.  
  3384.         <A>dd record, 27
  3385.         <A>ll system files, 29
  3386.         <A>udit trail toggle, 21
  3387.         <B>uild, 22
  3388.         <C>atalog operations, 22
  3389.         <D>elete record, 27
  3390.         <D>escribe, 22
  3391.         <E>dit, 23
  3392.         <E>dit record, 27
  3393.         <E>dit user record, 27
  3394.         <F>ile Transfer System, 32
  3395.         <F>orce password, 27
  3396.         <G>lobal, 25
  3397.         <G>oodbye (logoff), 32
  3398.         <I>nitialize system files, 28
  3399.         <J>ump to DOS, 29
  3400.         <L>eaders, 25
  3401.         <L>ist system files, 29
  3402.         <L>og file, 29
  3403.         <M>essage System, 32
  3404.         <M>essages, 29
  3405.         <N>ext record, 28
  3406.         <O> Macro operations, 29
  3407.         <P>ost, 26
  3408.         <P>revious record, 28
  3409.         <P>urge files, 31
  3410.         <Q>uit, 26, 29
  3411.         <Q>uit edit session, 28
  3412.         <R>econcile, 26
  3413.         <R>egistered, 28
  3414.         <S>elect record, 28
  3415.         <T>oggle printer, 32
  3416.         <U>tility System, 32
  3417.         <V>alidate user, 28
  3418.         <V>ersions, 32
  3419.         <X>pert mode toggle, 32
  3420.  
  3421.         Add, 23
  3422.  
  3423.         Backward, 23
  3424.         BUILDING A NEW FILE CATALOG, 41
  3425.  
  3426.         C/R  Using ROS locally, 19
  3427.         Change, 23
  3428.         Changing a Message Status or Message Area, 33
  3429.         Command Enhancements, 33
  3430.         COMMAND LINE OPTIONS, 36
  3431.         Configuring DOS, 4
  3432.         CONNECTING THE MODEM, 39
  3433.  
  3434.  
  3435.         48
  3436.                                      Index
  3437.  
  3438.  
  3439.  
  3440.         Delete, 23
  3441.  
  3442.         Edit, 24
  3443.  
  3444.         F2   Direct connection, 19
  3445.         F3   Delayed disable, 20
  3446.         F4   Disable remote I/O, 20
  3447.         F5   Sysop initiated CHAT, 20
  3448.         F6   Signal key, 20
  3449.         F9   Twit key, 20
  3450.         FILES, 3
  3451.         Forward, 24
  3452.  
  3453.         Hide, 24
  3454.         HISTORY AND ACKNOWLEDGMENTS, 1
  3455.  
  3456.         INSTALLING ROS, 4
  3457.         INVOICE, 47
  3458.  
  3459.         Local console commands, 19
  3460.         Logging in the first time, 18
  3461.  
  3462.         Macro Examples, 30
  3463.         MAINTENANCE, 21
  3464.         Message and file area control file - AREA.ROS, 4
  3465.         MINIMUM SYSTEM, 2
  3466.  
  3467.         Next, 25
  3468.  
  3469.         Option /d, 37
  3470.         Option /m, 37
  3471.         Option /o=, 37
  3472.         Option /r, 36
  3473.         Other commands available to the sysop, 32
  3474.         Other files used by ROS, 16
  3475.         OTHER VERSIONS OF ROS, 38
  3476.  
  3477.         Previous, 25
  3478.         Purge All, 31
  3479.         Purge Catalog, 31
  3480.         Purge Log, 31
  3481.         Purge Messages, 31
  3482.         Purge Users, 31
  3483.  
  3484.         Quit, 25
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.                                                                        49
  3493.                                      Index
  3494.  
  3495.  
  3496.         Release, 25
  3497.         ROS configuration file - CONFIG.ROS, 7
  3498.         ROS USAGE AND PROBLEM REPORT, 45
  3499.  
  3500.         SECURITY, 35
  3501.         Select, 25
  3502.         Setting the System Time and Date, 33
  3503.         Shutdown ROS, 20
  3504.         Status line, 18
  3505.         Sysop Sub-system, 21
  3506.         System message file - SYSMTXT.ROS, 13
  3507.  
  3508.         Time Initiated Macro, 30
  3509.  
  3510.         User List Additions, 33
  3511.         USING THE SYSTEM, 18
  3512.  
  3513.         WARNING AND ERROR MESSAGES, 42
  3514.         When ROS is idling between users, 19
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.         50
  3550.  
  3551.